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1  Introduction 

Background 

Building  Composer  is  an  application  for  use  by  planners,  designers,  and  engi¬ 
neers  during  all  phases  of  a  facility’s  life  cycle.  Its  capabilities  may  be  broadly 
categorized  into  three  areas:  creation  of  a  project  brief  (architectural  program), 
creation  of  a  preliminary  floor  plan,  and  selection  of  systems  and  components. 
The  core  concept  of  Building  Composer  is  that  customer-specific  criteria  are 
specified  at  the  appropriate  level  of  detail,  from  the  project  to  the  individual 
space.  For  example,  a  customer  should  be  able  to  specify  that  district  steam  heat 
be  used  on  a  project,  that  masonry  load  bearing  walls  be  used  on  a  building,  that 
32Watt  T-8  florescent  lights  be  used  in  corridors,  or  that  a  particular  room  be 
painted  Oyster  White.  Various  design  wizards  and  analysis  wizards  perform 
specific  actions  based  upon  these  criteria  to  produce  an  Integrated  Model-Based 
Facility  Design. 

Criteria  Composer  is  the  name  used  to  describe  the  portion  of  Building  Composer 
used  to  create  a  project  brief.  It  includes  information  regarding  the  total  area  of 
the  project  and  some  allocation  of  area  to  specific  architectural  functions,  such  as 
circulation  and  offices.  The  level  of  detail  varies  from  project  to  project;  however, 
it  contains  enough  information  to  generate  a  preliminary  cost  estimate.  It  is  ac¬ 
ceptable  to  create  a  project  that  contains  a  list  of  architectural  functions  and 
their  allocated  areas  without  deciding  how  many  buildings  will  be  required.  On 
the  other  hand,  the  planner  may  create  a  project  with  detailed  information,  such 
as  the  number  of  buildings  and  the  number  of  stories  in  each  building.  Typi¬ 
cally,  the  planner  will  not  create  such  a  detailed  brief  from  scratch,  but  will  copy 
it  from  a  library  and  modify  it  as  required  to  suit  the  customer’s  needs. 


Objective 

The  specific  objective  of  this  work  was  to  develop  an  object  model  to  store  infor¬ 
mation  related  to  the  planning  and  design  of  a  facility,  to  be  used  as  the  basis  for 
the  development  of  an  application,  Building  Composer  and  Criteria  Composer,  to 
input,  display,  and  manipulate  this  data. 
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Approach 

An  object  model  that  supports  facility  planning  and  design  was  developed.  A 
core  set  of  functionality  was  developed  that  can  be  used  to  create  a  final  applica¬ 
tion  that  can  be  easily  extended  and  customized  by  the  application  developer. 


Mode  of  Tech  Transfer 

This  technology  will  be  transferred  to  Corps  districts  through  the  Totally  Inte¬ 
grated  Project  Delivery  (TIPD)  initiative  pilot  program.  To  transfer  the  research 
behind  criteria-based  design  into  the  industry  design  process,  ERDC  is  partici¬ 
pating  in  industry  initiatives  such  as  FIATEC,  a  joint  Construction  Industry  In¬ 
stitute  (CII)  effort,  Building  Lifecycle  Interoperable  Software  (BLIS)  and  the  In¬ 
ternational  Alliance  for  Interoperability  (IAI).  Customers  (Department  of  State, 
Army  Reserve,  and  National  Guard)  continue  to  support  products  in  this  area 
and  are  working  on  developing  criteria-based  design  standards. 
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2  Overall  Description 


The  Criteria  Composer  application  is  composed  of  three  separate  pieces:  the  un¬ 
derlying  object  model,  the  Building  Composer  core  library,  and  the  Criteria 
Composer  files.  The  object  model  provides  for  the  objects  that  are  constructed 
and  stored  persistently  within  the  database.  On  top  of  the  object  model  is  the 
Building  Composer  core  library.  This  piece  defines  the  software  architectural 
picture  of  the  main  Criteria  Composer  application.  This  core  library  defines  how 
other  add-ons  hook  into  and  interact  with  the  core  library.  The  Criteria  Com¬ 
poser  files  consist  of  those  that  create  the  add-on  and  define  how  to  present  the 
core  library  graphical  pieces  (Figure  1). 

The  following  report  discusses  these  three  pieces  and  their  important  aspects. 
The  audience  for  this  report  is  not  the  casual  user  of  either  of  these  pieces,  but  is 
aimed  at  developers  that  would  have  to  maintain,  upgrade,  or  perform  some 
other  modifications  to  the  underlying  code  base.  There  is  no  way  that  this  report 
can  review  and  discuss  all  of  the  details  within  these  three  pieces.  It  is  hoped 
that  this  report  will  provide  a  good  starting  point  for  the  developers  and  main- 
tainers  of  this  code  base. 


Figure  1.  Criteria  Composer  core  library  graphical  pieces. 
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3  Object  Model 


The  underlying  object  model  used  is  based  on  the  Industry  Foundation  Classes 
(IFC)  Version  1.5.  These  classes  are  defined  by  the  International  Alliance  for 
Interoperability  (IAI).  The  IAI  is  an  action-oriented,  not-for-profit  organization. 
Its  mission  is  to  define,  publish,  and  promote  specifications  for  IFC  as  a  basis  for 
project  information  sharing  in  the  building  industry  (architecture,  engineering, 
construction,  and  facilities  management).  The  information  sharing  is  worldwide, 
throughout  the  project  life  cycle,  and  across  all  disciplines  and  technical  applica¬ 
tions.  The  IFC  object  model  was  chosen  because  of  its  completeness  at  the  time 
of  initial  development.  This  model  best  represents  the  elements  found  in  a  facil¬ 
ity  design  and  can  be  extended  by  a  developer.  This,  in  addition  to  use  of  the  de¬ 
velopment  tools  StepTools,  made  the  IFC  object  model  easier  to  work  with.  The 
use  of  StepTools  would  help  jump-start  the  Java  development  by  transforming 
EXPRESS  entities  to  Java  classes.  The  IFC  object  model  file  is  written  in  the 
EXPRESS  syntax.  In  addition,  StepTools  provides  the  code  needed  to  import 
and  export  EXPRESS  entities  from  a  Part  21  file. 

Several  steps  transform  the  raw  IFC  EXPRESS  file  into  the  Java  classes  that 
are  used  in  the  final  object  model: 

1.  Run  the  EXPRESS  file  through  the  StepTools  application 

2.  Modify  the  generated  classes 

3.  Modify  the  resulting  class  and  interface  hierarchy 

4.  Implement  the  inverse  relationship  attributes 

5.  Add  new  classes. 


Run  EXPRESS  file  through  StepTools  application 

The  first  step  will  turn  the  EXPRESS  file  entities  into  a  set  of  Java  class  files. 
The  Standard  Data  Access  Interface  (SDAI)  Java  binding  from  StepTools  takes 
an  early-bound  approach.  Java  classes  are  created  for  all  of  the  entities  and 
types  in  an  EXPRESS  schema  to  hold  data.  The  EXPRESS  to  Java  translator 
requires  the  EXPRESS  parse  data  and  ROSE  meta-data  for  an  EXPRESS 
schema,  so  these  need  to  be  generated  first.  The  name  of  the  IFC  EXPRESS  file 
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is  IFCl50Final.exp.  (Appendix  A  give  for  a  complete  listing  of  the  IFC 
EXPRESS  file). 

This  will  generate  schema  information  in  a  file  called  <schema>.rose,  in  this  case 
IFCl50Final.rose. 


The  ST-Developer  Advanced  EXPRESS  compiler  expxfront  is  used  to  generate 
parse  data  used  by  the  EXPRESS  to  Java  compiler.  This  data  is  stored  in  the 
file  IFCl50Final_EXPX.rose.  Now  we  can  run  the  class  generator. 


Here  the  argument  is  the  name  of  the  parse  data  file,  not  the  name  of  the 
EXPRESS  file.  This  generates  a  Java  class  and  interface  files  for  the  types  and 
entities  in  the  schema  in  subdirectories  SDAI.<packages>  and 
SDAI.COM.steptools.<packages>. 


Modify  Generated  Classes 


The  automatically  generated  classes  from  StepTools  are  minimal.  There  is  only 
a  default  no  parameter  constructer  and  no  business  logic  created.  Added  to  this 
is  the  complexity  that  is  built  into  the  IFC  object  model.  Though  a  fairly  com¬ 
plete  model  of  a  facility,  it  is  also  very  flexible  in  its  use.  As  a  result  of  this  flexi¬ 
bility,  the  model  can  be  complex  to  use.  In  an  effort  to  make  the  model  easier  to 
use,  parameter  constructors,  additional  debugging  methods,  and  “helper”  wrap¬ 
per  methods  were  added  to  some  generated  classes.  Below  are  a  few  examples  of 
this  added  code.  (Appendix  B  includes  a  complete  listing  of  files  modified). 


Here  is  code  added  to  the  Clfccartesianpoint  class  for  a  more  complete  toString 
method  and  additional  constructors: 


public  String  toStringQ  { 

String  temp  =  new  String("["  +  getGUIDQ  +  ":Ver:”  +  getVersion()  + ",  {"); 
if  (Coordinates  !=  null)  { 

for  (int  i  =  0 ;  i  <  Coordinates. length;  ++I)  { 
temp  +=  Coordinates^]; 
if  (i  !=  Coordinates.length-1 )  temp  += 

} 

} 

temp  += 
return  temp; 

} 

public  Clfccartesianpoint(double  x,  double  y,  double  z)  { 
setCoordinates(new  double]]  {x,  y,  z}); 

} 

public  Clfccartesianpoint(double  x,  double  y)  { 
setCoordinates(new  double]]  {x,  y}); 

} 

public  Clfccartesianpoint(double[]  coords)  { 
setCoordinates(coords); 

} 
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Here  is  code  added  to  the  Clfcproductshape  class  to  add  methods  to  make  con¬ 
struction  of  a  bounding  box  and  its  manipulation  easier: 


/**  Constructs  a  bounding  box  product  shape. 

*  The  bounding  box  position  is  set  to  "new  Clfcaxis2placement3d(new  Cifccartesianpoint(0,  0, 0))”.  */ 

public  static  Clfcproductshape  productshape_boundingBox_create(double  xSize,  double  ySize,  double  zSize)  { 

Clfcboundingbox  box  =  new  Clfcboundingbox(new  Clfcaxis2placement3d(new  Clfccartesianpoint(0,  0, 0)),  xSize,  ySize,  zSize); 
Clfcshaperepresentation  shapeRep  =  new  Clfcshaperepresentation(); 
shapeRep.setRepresentationtype(Clfcshapereptypeenum.BOUNDINGBOX); 
shapeRep. setltems(new  ElfcgeometricrepresentationitemO  {box}); 

Clfcshapebody  body  =  new  Clfcshapebody(); 
body.setRepresentations(new  ElfcshaperepresentationO  {shapeRep}); 

Clfcproductshape  prodShape  =  new  ClfcproductshapeQ; 
prodShape.getProductcomponentshape().setlfcshapebody(body); 
return  prodShape; 


public  boolean  productshape_isA_boundingBox()  { 
boolean  result  =  false; 

if  (getProductcomponentshapeQ.islfcshapebodyO  ==  SDAl.lang.LOGICAL.TRUE)  { 

Elfcshapebody  body  =  getProductcomponentshape().getlfcshapebody(); 

ElfcshaperepresentationO  shapeReps  =  body.getRepresentations(); 
if  (shapeReps  !=  null)  { 

for  (int  i  =  0;  i  <  shapeReps.length;  i++)  { 
if  (shapeReps[i]  !=  null)  { 

if  (shapeReps[i].getRepresentationtype()  ==  Clfcshapereptypeenum.BOUNDINGBOX)  { 
result  =  true; 

} 

} 

} 

} 

} 

return  result; 


public  Elfcboundingbox  productshape_boundingBox_get()  { 

Elfcboundingbox  result  =  null; 

if  (productshape_isA_boundingBox()  ==  false)  return  null; 

if  (getProductcomponentshape().islfcshapebody()  ==  SDAl.lang.LOGICAL.TRUE)  { 

Elfcshapebody  body  =  getProductcomponentshape().getlfcshapebody(); 

ElfcshaperepresentationO  shapeReps  =  body.getRepresentations(); 
if  (shapeReps  !=  null)  { 

for  (int  i  =  0;  i  <  shapeReps.length;  i++)  { 
if  (shapeReps[i]  !=  null)  { 

if  (shapeReps[i].getRepresentationtype()  ==  Clfcshapereptypeenum.BOUNDINGBOX)  { 
ElfcgeometricrepresentationitemO  geoReps  =  shapeReps[i].getltems(); 
result  =  (Elfcboundingbox)geoReps[0]; 


return  result; 


} 


public  void  productshape_boundingBox_setXdim(double  v)  { 
if  (productshape_isA_boundingBox()  ==  false)  return; 
productshape_boundingBox_get().setXdim(v); 

} 


public  void  productshape_boundingBox_setYdim(double  v)  { 
if  (productshape_isA_boundingBox()  ==  false)  return; 
productshape_boundingBox_get().setYdim(v); 

} 

public  void  productshape_boundingBox_setZdim(double  v)  { 
if  (productshape_isA_boundingBox()  ==  false)  return; 
productshape_boundingBox_get().setZdim(v); 

} 


public  double  productshape_boundingBox_getXdim()  { 

if  (productshape_isA_boundingBox()  ==  false)  return  -1; 
return  productshape_boundingBox_get().getXdim(); 
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} 

public  double  productshape_boundingBox_getYdim()  { 

if  (productshape_isA_boundingBox()  ==  false)  return  -1; 
return  productshape_boundingBox_get().getYdim(); 

} 

public  double  productshape_boundingBox_getZdim()  { 

if  (productshape_isA_boundingBox()  ==  false)  return  -1 ; 
return  productshape_boundingBox_get().getZdim(); 

} 


Modify  Class  and  Interface  Hierarchy 

One  of  the  results  of  the  StepTools  process  is  that  the  resulting  class  hierarchy  is 
“flattened”  out.  For  example,  if  there  were  this  hierarchy  before  in  the 
EXPRESS  file  (Figure  2),  the  result  would  be  the  structure  shown  in  Figure  3. 


Figure  2.  Class  hierarchy  before  in  the  EXPRESS  file. 


Class  CAppJns 


<h 


Class  CA 

Class  CB 

Class  CC 

- n — 

- o — 

Interface  EA 


<h 


Interface  EB 


Interface  EC 


Figure  3.  Result  of  Step  Tools  process. 
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Each  class  file  generated  (a  “C”  is  added  before  the  class  name)  has  a  correspond¬ 
ing  interface  file  generated  (an  “E”  is  added  before  the  class  name)  that  defines 
the  method  signatures  for  the  class.  The  code  for  these  methods  is  then  created 
in  each  class  that  implements  an  interface.  In  the  example  above,  the  code  for 
any  methods  in  Class  A  would  be  repeated  in  Class  A,  Class  B,  and  Class  C. 
This  “flattening”  of  the  object  model  results  from  the  fact  that  an  EXPRESS  file 
can  define  classes  with  multiple  inheritances.  Java,  on  the  other  hand,  cannot 
do  multiple  inheritances.  Therefore  StepTools  flattens  the  actual  Java  class 
files,  but  maintains  the  inheritance  through  the  Java  interface  files.  Internally 
the  Java  classes  pass  and  return  interface  objects  from  methods  to  allow  this 
new  hierarchy  to  work.  For  example: 

public  class  Clfcsite  implements  Elfcsite  { 

public  final  Elfcoccurrencepropertyset[]  getOccurrencepropertiesQ 
public  final  void  setOccurrenceproperties(Elfcoccurrencepropertyset[]  v) 

} 

The  “flattening”  out  of  the  object  model  makes  modification  of  code  and  addition 
of  new  functionality  difficult.  It  is  necessary  to  modify  the  code  in  several  places. 
To  ease  this  problem,  several  custom  classes  are  added  within  the  hierarchy  to 
try  and  restore  the  original  hierarchy. 


The  following  shows  a  more  complex  example  of  how  some  of  the  IFC  object 
model  is  transformed  through  the  StepTools  process.  The  following  shows  the 
EXPRESS  code  for  an  IfcRoot,  IfcObject,  and  IfcProject  object: 

ENTITY  IfcRoot 

ABSTRACT  SUPERTYPE  0F(  ONEOF( 

IfcObject 
JfcRelationship 
,  IfcModel  i  ngAid)) ; 

Projectld  :  IfcProjectUniqueld; 

UNIQUE 
UR1:  Projectld; 

END_ENTITY; 

ENTITY  IfcObject 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcProduct 
JfcProcess 
,  IfcControl 
JfcDocument 
JfcGroup 
,  IfcProject 
JfcProxy 
JfcResource)) 

SUBTYPE  OF  (IfcRoot); 

OwnerHistory  :  IfcOwnerHistory; 

TypeDefinitions  :  LIST  [0:?]  OF  IfcPropertyTypeDef; 

OccurrenceProperties  :  LIST  [0:?]  OF  IfcOccurrencePropertySet; 

ExtendedProperties  :  LIST  [0:?]  OF  IfcPropertySet; 

INVERSE 

PartOfGroups  :  SET  [0:?]  OF  IfcRelGroups 
WHERE 

WR1:  SIZEOF(QUERY(temp  <*  ExtendedProperties  | 

('IFC150FINAL. IFCOCCURRENCEPROPERTYSET'  IN  TYPEOF(temp)) 

OR 

('IFC150FINAL.IFCSHAREDPROPERTYSET'  IN  TYPEOF(temp)))) 

=  0; 

END_ENTITY; 

ENTITY  IfcProject 
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SUBTYPE  OF  (IfcObject); 


Globalld 
UnitsInContext 
ProjectTeam 
ProjectApps 
Classification 
AbsolutePlacement 
END  ENTITY; 


:  OPTIONAL  IfcGloballyUniqueld; 

:  IfcUnitAssignment; 

:  IfcProjectTeamRegistry; 

:  IfcProjectAppRegistry; 
OPTIONAL  IfcClassificationList; 
lfcAxis2Placement; 


The  following  shows  some  of  the  resulting  Java  files  generated  (the  class  files  for 
IfcRoot  and  IfcObject  are  not  shown): 


public  interface  Elfcroot  extends  lnt_MDSApplnst  { 
java.  lang.  String  getProjectidQ; 
void  setProjectid(java.lang.String  v); 


public  interface  Elfcobject  extends  Elfcroot  { 

Elfcpropertytypedefj]  getTypedefinitions(); 
void  setTypedefinitions(Elfcpropertytypedef[]  v); 
Elfcoccurrencepropertysetj]  getOccurrenceproperties(); 
void  setOccurrenceproperties(Elfcoccurrencepropertyset[]  v); 
Elfcrelgroupsj]  getPartofgroups(); 

Elfcpropertysetj]  getExtendedproperties(); 
void  setExtendedproperties(Elfcpropertyset[]  v); 
Elfcownerhistory  getOwnerhistory(); 
void  setOwnerhistory(Elfcownerhistory  v); 


public  interface  Elfcproject  extends  Elfcobject  { 
Elfcaxis2placement  getAbsoluteplacement(); 
void  setAbsoluteplacement(Elfcaxis2placement  v); 
java. lang. String  getGlobalid(); 
void  setGlobalidjjava.  lang.  String  v); 
Elfcclassificationlist  getClassificationQ; 
void  setClassification(Elfcclassificationlist  v); 
Elfcprojectteamregistry  getProjectteam(); 
void  setProjectteam(Elfcprojectteamregistry  v); 
Elfcprojectappregistry  getProjectapps(); 
void  setProjectappsjElfcprojectappregistry  v); 
Elfcunitassignment  getUnitsincontext(); 
void  setUnitsincontext(Elfcunitassignment  v); 


public  class  Clfcproject  implements  Elfcproject  { 

public  ClfcprojectQ  { 

} 

public  C lfcproject(SD Al . lang . Model_contents  me)  throws  SDAl.lang.SdaiException  { 
mc.movelnstance(this); 

} 

public  String  GetlnstanceTypeBNQ  { 
return  "Ifcproject"; 

} 

public  Class  GetlnstanceTypeQ  { 
return  Elfcproject.class; 

} 

public  Entitylnfo  getDomainlnfoQ  { 
return  domainlnfo; 

} 

public  static  Entitylnfo  domainlnfo  =  null; 

public  final  Elfcaxis2placement  getAbsoluteplacement()  { 
return  Absoluteplacement; 

} 

public  final  void  setAbsoluteplacement(Elfcaxis2placement  v)  { 

Absoluteplacement  =  v; 

} 

public  final  java.lang. String  getGlobalid()  { 
return  Globalid; 

} 

public  final  void  setGlobalid(java.lang. String  v)  { 

Globalid  =  v; 

} 

public  final  Elfcclassificationlist  getClassificationQ  { 
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return(Elfcclassificationlist)Classifi  cation; 

} 

public  final  void  setClassification (E Ifcclassification list  v)  { 

Classification  =  v; 

} 

public  final  java.lang. String  getProjectid()  { 
return  Projectid; 

} 

public  final  void  setProjectid(java.lang.String  v)  { 

Projectid  =  v; 

} 

public  final  Elfcpropertytypedefj]  getT ypedefinitions()  { 
return(Elfcpropertytypedef[])Typedefinitions; 

} 

public  final  void  setTypedefinitions(Elfcpropertytypedef[]  v)  { 

Typedefinitions  =  v; 

} 

public  final  Elfcoccurrencepropertysetj]  getOccurrenceproperties()  { 
return(Elfcoccurrencepropertyset[])Occurrenceproperties; 

} 

public  final  void  setOccurrenceproperties(Elfcoccurrencepropertyset[]  v)  { 

Occurrenceproperties  =  v; 

} 

public  final  Elfcrelgroupsj]  getPartofgroups()  { 

throw  new  SdaiRuntimeException(SdaiException.FN_NAVL); 

} 

public  final  Elfcpropertysetj]  getExtendedproperties()  { 
return(Elfcpropertyset[])Extendedproperties; 

} 

public  final  void  setExtendedproperties(Elfcpropertyset[]  v)  { 

Extendedproperties  =  v; 

} 

public  final  Elfcprojectteamregistry  getProjectteam()  { 
return(Elfcprojectteamregistry)Projectteam; 

} 

public  final  void  setProjectteam(Elfcprojectteamregistry  v)  { 

Projectteam  =  v; 

} 

public  final  Elfcprojectappregistry  getProjectapps()  { 
return(Elfcprojectappregistry)Projectapps; 

} 

public  final  void  setProjectapps(Elfcprojectappregistry  v)  { 

Projectapps  =  v; 

} 

public  final  Elfcunitassignment  getllnitsincontext()  { 
return(Elfcunitassignment)Unitsincontext; 

} 

public  final  void  setllnitsincontext(Elfcunitassignment  v)  { 

Unitsincontext  =  v; 

} 

public  final  Elfcownerhistory  getOwnerhistory()  { 
return(Elfcownerhistory)Ownerhistory; 

} 

public  final  void  setOwnerhistory(Elfcownerhistory  v)  { 

Ownerhistory  =  v; 

} 

public  void  copylnstance(App_inst  a)  { 

Elfcproject  ca  =  (Elfcproject)  a; 

Absoluteplacement  =  ca.getAbsoluteplacementQ; 

Globalid  =  ca.getGlobalid(); 

Classification  =  ca.getClassification(); 

Projectid  =  ca.getProjectid(); 

Typedefinitions  =  (Elfcpropertytypedefj])  SDAIutil.makeCopy(ca.getTypedefinitionsQ); 
Occurrenceproperties  =  (Elfcoccurrencepropertysetj])  SDAIutil.makeCopy(ca.getOccurrenceproperties()); 
Extendedproperties  =  (Elfcpropertyset]])  SDAIutil.makeCopy(ca.getExtendedproperties()); 

Projectteam  =  ca.getProjectteam(); 

Projectapps  =  ca.getProjectapps(); 

Unitsincontext  =  ca.getUnitsincontext(); 

Ownerhistory  =  ca.getOwnerhistory(); 

} 

public  Elfcaxis2placement  Absoluteplacement  =  new  Clfcaxis2placement(); 

public  java.lang. String  Globalid  =  null; 

public  Object  Classification  =  null; 

public  java.lang. String  Projectid  =  null; 

public  Objectj]  Typedefinitions  =  null; 

public  Objectj]  Occurrenceproperties  =  null; 

public  Objectj]  Extendedproperties  =  null; 
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public  Object  Projectteam  =  null; 
public  Object  Projectapps  =  null; 
public  Object  Unitsincontext  =  null; 
public  Object  Ownerhistory  =  null; 

} 

As  can  be  seen,  the  interface  files  follow  the  hierarchy  of  the  original  IFC  object 
model.  The  Clfcproject  class  file,  on  the  other  hand,  does  not  extend  from  the 
Clfcobject  class  file — the  class  hierarchy  has  been  “flattened.”  The  class  files 
generated  do  have  the  code  for  their  attribute  accessor  methods,  but  no  business 
logic  code  is  generated.  Also  note  that  the  “INVERSE”  attribute  PartOfGroups 
in  the  IfcObject  object  did  have  a  method  generated  in  the  Elfcobject  interface, 
but  the  accessor  method  in  the  Clfcproject  class  would  throw  a  runtime  exception 
if  called.  It  is  left  to  the  developer  to  complete  the  coding  of  these  “INVERSE” 
attributes  (see  section  “Implement  Inverse  Relationship  Attributes”  below). 


To  help  make  the  addition  of  code  easier  and  to  add  new  needed  functionality, 
new  classes  were  created  that  are  similar  to  the  IFC  classes,  but  added  into  the 
hierarchy  tree.  The  code  was  placed  in  these  new  custom  classes  to  help  isolate 
them  from  the  code  in  the  automatically  generated  classes.  This  isolation  would 
make  later  processes  of  the  EXPRESS  file  through  the  StepTools  application 
safer  (the  code  may  not  be  accidentally  lost).  These  new  classes  were  inserted 
into  the  class  hierarchy  before  (as  opposed  to  after)  the  IFC  class  so  that  an  in¬ 
stance  of  the  IFC  object  would  have  the  added  functionality.  Here  is  a  partial 
view  of  the  IFC  object  model  with  the  new  custom  classes  inserted: 

class  java. lang.Object 

o  class  CAppJnst 

■  class  MDSAppInst 

•  class  MDSObject 

o  class  Clfcobject 
o  class  MDSProduct 

■  class  Clfcproduct 

■  class  MDSBuilding 

•  class  Clfcbuilding 

■  class  MDSBuildingStorey 

•  class  Clfcbuildingstorey 

■  class  MDSEIement 

•  class  Clfcelement 

■  class  MDSSite 

•  class  Clfcsite 

o  class  MDSProject 

■  class  Clfcproject 


MDSAppInst 

The  first  custom  class  created  was  MDSAppInst  (interface  IntJMDSAppInst). 
This  class  would  become  the  new  root  class  for  all  objects.  To  insert  this  class 
into  the  hierarchy,  it  is  necessary  to  modify  all  classes  that  extend  from 
CApp_inst  to  extend  from  MDSAppInst.  It  is  also  necessary  to  add  the  interface 
Int_MDSAppInst  into  the  interface  hierarchy.  The  modified  class  hierarchy  is: 
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Class  CAppJnst 

>  Class  MDSAppInst  extends  CAppJnst  implements  lnt_MDSApplnst 

>  Class  Clfc2dcompositecurve  extends  MDSAppInst  implements  Elfc2dcompositecurve 

>  Class  Clfcactorrole  extends  MDSAppInst  implements  Elfcactorrole 


Addition  of  the  MDSAppInst  class  allows  for  a  central  place  to  modify  code  that 
should  be  applied  to  all  classes  within  the  object  model.  There  were  several 
modifications  that  were  done:  automatic  generation  of  a  global  unique  identifier 
(GUID),  ability  to  display  debug  information,  and  ability  to  export  to  an  IFC  file. 


To  accomplish  the  automatic  generation  of  a  GUID,  a  default  public  constructor 
was  created.  In  this  constructor,  a  GUID  is  generated  from  three  parts.  First  is 
the  name  of  the  class,  second  is  the  count  of  objects  created  to  this  point  during 
this  running  of  the  application,  and  third  is  a  random  number  based  on  the  time 
that  this  object  is  created.  A  sample  GUID  would  be  “CIfcproject_xOx_- 
3628410943273228335”  for  a  Clfcproject  object.  Here  is  the  code  for  the  con¬ 
structor  and  GUID  generator  is: 

/**  Default  constructor.  A  m_guid  is  created  during  construction.  7 
public  MDSApplnst()  { 

setGUID(generateGUID(classNameFinalPortion())); 
count  +=  1;  II  update  counter 

} 

/**  Utility  to  return  the  final  portion  of  a  class  name.  If  full  class  name  is  'packagel  .package2.classA',  this  will  return  'dassA'.  7 
public  final  String  classNameFinalPortionQ  { 

II  get  final  portion  of  class  name  as  base  for  m_guid 

return  getClass().getName().substring(getClass().getName().lastlndexOf('.')  + 1); 

} 

/**  Routine  to  generate  GUID.  GUID  is:  base  +  "_x_"  +  count  +  "_x_”  +  random  number  7 
private  static  String  generateGUID(String  base)  { 

StringBuffer  tmp  =  new  StringBuffer(base); 

Random  rand  =  new  Random)); 

tmp.appendfjx"); 

tmp.append(count); 

tmp.appendfxj'); 

tmp.append(rand.nextLong()); 

return  tmp.toString(); 


In  addition,  the  IFC  model  has  the  concept  of  a  GUID  in  a  variable  called  the 
“Projectid.”  Not  every  class  has  this  variable.  It  was  decided,  however,  to  move 
this  variable  into  the  MDSAppInst  class  and  apply  it  to  all  objects.  It  was  there¬ 
fore  necessary  to  comment  out  this  variable  in  several  StepTools  generated 
classes. 


The  next  modification  was  the  ability  to  display  some  simple  debug  information 
about  an  instance.  The  basic  way  of  doing  this  was  by  overriding  the  “toString” 
method  and  implementing  a  new  “dump”  method: 

public  void  dump()  { 

System.out.printf1 '==  OBJECT  == "  +  classNameFinalPortion()  +  ”, "  +  toString!)  +  "\n"); 

} 

public  String  toString!)  { 

return  new  String("["  +  getGUID()  +  ":Ver:"  +  getVersion()  + "]"); 

} 
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A  more  advanced  way  of  displaying  debug  information  was  also  created.  This 
used  the  Java  reflection  technique  to  examine  an  object  at  runtime  and  to  de¬ 
termine  the  data  to  display.  Using  the  reflection  technique,  it  is  not  necessary  to 
rewrite  this  code  for  every  class: 

II  routine  to  print  to  system.out  the  internal  field  values 
public  void  dumpInternalsO  { 

processClasslnternals(true); 

} 

II  routine  to  retrieve  the  internal  field  values  as  a  vector  of  strings 
public  Vector  getlnternals()  { 

return  processClasslnternals(false); 

} 

private  Vector  processClasslnternals(boolean  display)  { 

Vector  internals  =  new  Vector)); 

try  ( 

Class  c  =  getClass(); 

if  (display  ==  true)  System.out.printlnflnstance "  +  this); 
if  (display  ==  true)  System.out.println("Class "  +  c); 
processFieldlnternals(internals,  display,  c,  this); 

Class  superC  =  c.getSuperclass(); 
while  (superC  !=  null)  { 

if  (display  ==  true)  System.out.printlnfSuperclass "  +  superC); 
if  (superC  ==  Class.forNamef'java.Iang.Object")) 
superC  =  null; 

else  if  (superC  ==  Class.forName("SDAI.COM.steptools.CApp_inst")) 
superC  =  null; 

else  { 

processFieldlnternals(internals,  display,  superC,  this); 
superC  =  superC.getSuperclass(); 

} 

} 

} 

catch  (Exception  exc)  { 

exc.  pri  ntStackT  race(); 

} 

return  internals; 

} 

private  void  processFieldlnternals(Vector  internals,  boolean  display,  Class  c,  Object  inst)  { 

String  field; 

try  ( 

Field[]  fields  =  c.getDeclaredFields(); 
for  (int  i  =  0;  i  <  fields.length;  i++)  { 

try  { 

Object  obj  =  fields[i].get(this); 

field  =  new  String(c.getName()  + +  fields[i].getName()  + "  +  obj); 

internals.addElement(field); 

if  (display  ==  true) 

System.out.println(c.getName()  + +  fields[i].getName()  + "  +  obj); 
if  (obj  !=  null)  { 

Class  cl  =  obj.getClass(); 
if  (obj.getClassQ.isArrayQ)  { 
if  (display  ==  true) 

System.out.printlnfT  +  obj.getClass().getComponentType().getName()  + "["  +  Array.getLength(obj)  + "]"); 

} 

} 

} 

catch  (HlegalAccessException  exc)  { 

System.out.println(c  + "  IliegalAccessException, "  +  fields[i].getName()); 

} 

} 

} 

catch  (Exception  exc)  { 

exc.printStackTrace(); 

} 

} 
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The  final  modification  was  to  add  the  capability  to  export  the  object  (and  its 
variables)  to  an  IFC  file.  Through  classes  and  methods  inherited  from  Step- 
Tools,  an  object  can  be  added  to  a  repository  that  can  then  be  written  out  to  a  file 
(see  StepTools  documentation  for  more  details).  The  methods  added  employ  the 
Java  reflection  technique,  used  in  the  advanced  debug  display  described  above, 
to  make  sure  that  all  object  variables  are  added  to  this  repository.  The  following 
methods  are  added: 


II  routine  to  dump  to  a  part  21  file  this  instance  and  any  attribute  object  variables 
public  void  dumpTolFC(SDAI.Iang.Model_contents  me)  { 
if  (dumpingTolFC)  return; 
dumpingTolFC  =  true; 

try  { 

II  move  this  object  to  the  model  contents 
if  (this  instanceof  SDAl.lang.AppJnst)  { 

if  (classNameFinalPortionQ.startsWithf'Clfc")  || 
classNameFinalPortionQ.startsWithf'Elfc"))  { 
mc.movelnstance((SDAI.Iang.App_inst)this); 

} 

} 

II  go  up  heirarchy  chain  adding  parent  class  fields 
Class  superC  =  getClass().getSuperclass(); 
while  (superC  !=  null)  { 

if  (superC  ==  Class.forNamef'java.Iang.Object")) 
superC  =  null; 

else  if  (superC  ==  Class.forName("SDAI.COM.steptools.CApp_insf')) 
superC  =  null; 

else  if  (superC  ==  Class.forName("SDAI.COM.steptools.Slfc150final.MDSApplnst")) 
superC  =  null; 

else  { 

dumpTolFCHelper(superC,  this,  me); 
superC  =  superC.getSuperclass(); 

} 

} 

II  add  main  class  fields 
dumpTolFCFielper(getClass(),  this,  me); 
dumpingTolFC  =  false; 

} 

catch  (Exception  exc)  { 

System.out.printlnf'Exception  Dumping  - 1: "  +  this); 

exc.printStackTrace(); 

dumpingTolFC  =  false; 

} 

} 

private  void  dumpTolFCHelper(Class  c,  Object  inst,  Model_contents  me)  { 

try  { 

II  check  for  any  fields  to  be  moved  to  the  model  contents 
Field[]  fields  =  c.getDeclaredFields(); 
for  (int  i  =  0;  i  <  fields.length;  i++)  { 

try  { 

Object  obj  =  fields[i].get(inst); 
if  (obj  !=  null)  { 

if  (obj  instanceof  lnt_MDSDumpTolFC)  { 

((lnt_MDSDumpTolFC)obj).dumpTolFC(mc); 

} 

if  (obj.getClass().isArray())  { 

for  (int  j  =  0;  j  <  Array.getLength(obj);  j++)  { 

if  (Array ,get(obj,  j)  instanceof  lnt_MDSDumpTolFC)  { 

((lnt_MDSDumpTolFC)Array.get(obj,  j)).dumpTolFC(mc); 

} 

} 

} 

} 

} 

catch  (HlegalAccessException  exc)  { 

System.out.printlnf'Exception  Dumping  -  2: "  +  this); 

System  .out.  println("  1 1  legal  Access  on  Field: +  fields[i].getName()  + . ); 

} 

} 

} 
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catch  (Exception  exc)  { 

System.out.printlnfException  Dumping  -  3: "  +  this); 
exc.printStackTrace(); 

} 

} 

The  dumpToIFC  method  had  to  be  overridden  in  several  classes  to  refine  the  ex¬ 
porting  of  an  object  and  its  variables  to  an  IFC  file. 


Other  Custom  Classes 

Next  custom  classes  MDSObject  (interface  Int_MDSObject),  MDSProduct  (inter¬ 
face  Int_MDSProduct),  MDSProject  (interface  IntJMDSProject),  MDSSite, 
MDSBuilding,  MDSBuildingStorey,  MDSSpace,  MDSElement,  MDSRelation- 
shipltol,  and  MDSRelationshipltoN  were  created  and  added  into  the  class  and 
interface  hierarchy. 


MDSObject 


The  MDSObject  class  was  created  to  add  methods  to  support  property  capability 
to  lower  classes.  This  capability  is  provided  through  the  use  of  the  IFC  IF- 
CPropertySet  objects  and  the  “extendedProperties”  attribute  of  the  IFCObject 
object.  The  IFC  objects  and  methods  that  provide  property  capability  can  be  dif¬ 
ficult  to  negotiate.  The  methods  added  in  MDSObject  provide  a  wrapper  to  this 
complexity  to  simplify  the  process  of  adding  properties  to  an  object.  Here  are  a 
few  of  those  methods: 


/** 

*  Returns  true  if  the  given  descriptor  exists  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*/ 

public  boolean  existsProperty(String  descriptor)  { 

if  (isMDSBasePropertySetQ  ==  false)  return  false; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 
return  getSimpleProperty(mdsBasePropSet,  descriptor)  !=  null; 

} 

/** 

*  Removes  the  given  descriptor  from  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  This  will  remove  all  properties  with  the  given  descriptor. 

*/ 

public  void  removeProperty(String  descriptor)  { 
if  (isMDSBasePropertySetQ  ==  false)  return; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySet(); 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  !=  null)  { 

removeSimpleProperty(mdsBasePropSet,  prop); 

} 

} 

/** 

*  Adds  a  new  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  No  check  is  made  first  if  the  descriptor  already  exists! 

*  Sets  the  value  as  an  IFCDescriptiveMeasure. 

*/ 

public  void  addStringProperty(String  descriptor,  String  value)  { 

if  (isMDSBasePropertySetQ  ==  false)  setupMDSBasePropertySetQ; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  ==  null)  { 

prop  =  new  ClfcsimplepropertyQ; 

} 

prop.setDescriptor(descriptor); 
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prop.getValuecomponent().setlfcdescriptivemeasure(value); 
addSimpleProperty(mdsBasePropSet,  prop); 

} 

/** 


*  Adds  a  new  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  No  check  is  made  first  if  the  descriptor  already  exists! 

*  Sets  the  value  as  an  IFCNumericMeasure. 

*/ 

public  void  addDoubleProperty(String  descriptor,  Double  value)  { 

if  (isMDSBasePropertySetQ  ==  false)  setupMDSBasePropertySetQ; 
Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySet(); 
Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  ==  null)  { 

prop  =  new  Clfcsimpleproperty(); 

} 

prop.setDescriptor(descriptor); 

prop.getValuecomponent().setlfcnumericmeasure(value.doubleValue()); 
addSimpleProperty(mdsBasePropSet,  prop); 

} 

/** 

*  Gets  a  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  Returns  the  first  matching  descriptor! 

*  The  return  value  is  null  if  property  not  found. 

*/ 


public  String  getStringProperty(String  descriptor)  { 
if  (isMDSBasePropertySetQ  ==  false)  return  null; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySet(); 
Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  !=  null)  { 

return  prop.getValuecomponent().getlfcdescriptivemeasure(); 

} 

return  null; 

} 

/** 


*  Gets  a  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  Returns  the  first  matching  descriptor! 

*  The  return  value  is  null  if  property  not  found. 

*/ 

public  Double  getDoubleProperty(String  descriptor)  { 
if  (isMDSBasePropertySetQ  ==  false)  return  null; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 
Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  !=  null)  { 

return  new  Double(prop.getValuecomponent().getlfcnumericmeasure()); 

} 

return  null; 

} 

/** 


*  Gets  a  vector  of  descriptors  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*/ 


public  Vector  getPropertyTitles()  { 

Vector  result  =  new  Vector(); 
if  (isMDSBasePropertySetQ  ==  false)  return  result; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 

ElfcpropertyQ  props  =  mdsBasePropSet.getHaspropertiesQ; 
if  (props  !=  null)  { 

for  (int  i  =  0;  i  <  props.length;  i++)  { 

result.addElement(((Elfcsimpleproperty)props[i]).getDescriptor()); 

} 

} 

return  result; 


MDSProduct 


The  MDSProduct  class  was  created  to  add  methods  to  support  geometric  capabil¬ 
ity  to  lower  classes.  A  default  constructor  creates  a  local  placement  location  and 
a  zero  size  bounding  box  for  an  object.  As  with  IFC  property  support,  there  are 
geometry  methods  in  the  IFC  object  model.  Again,  however,  these  can  be  diffi¬ 
cult  to  negotiate.  MDSProduct  defines  methods  to  simplify  some  geometric  ca- 
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pabilities  for  an  object.  The  defined  default  constructor  (and  some  other  meth¬ 
ods)  are: 


public  abstract  class  MDSProduct  extends  MDSObject  implements  lnt_MDSProduct  { 

/** 

*  A  local  placement  object  is  automatically  created. 

*  A  bounding  box  product  shape  (size  0, 0, 0)  is  automatically  created. 

*1 

public  MDSProduct()  { 

setLocalplacement(new  Clfclocalplacement(new  Clfcaxis2placement3d(new  Clfccartesianpoint(0, 0,  0)))); 
setProduotshape(Clfcproductshape.productshape_boundingBox_create(0,  0, 0)); 

} 

II -  - 

II  these  methods  are  redefined  in  subclasses! 

public  Elfclocalplacement  getLocalplacement()  { 

System.out.println("MDSProduct:getLocalplacement,  SHOULD  NOT  BE  HERE!''); 
return  null; 

} 

public  void  setLocalplacement(Elfclocalplacement  v)  { 

System.out.println("MDSProduct:setLocalplacement,  SHOULD  NOT  BE  HERE!"); 
return; 

} 

public  Elfcproductshape  getProductshapeQ  { 

System.out.println("MDSProduct:getProductshape,  SHOULD  NOT  BE  HERE!1'); 
return  null; 

} 

public  void  setProductshape(Elfcproductshape  v)  { 

System.out.println("MDSProduct:setProductshape,  SHOULD  NOT  BE  HERE!"); 
return; 

} 

II - 

//================================================================================================ 

II  LOCATION  ROUTINES 

//================================================================================================= 

public  void  setRelativeLocation(Elfccartesianpoint  location)  { 
if  (location  ==  null)  return; 
if  (getLocalplacementO  =  null)  return; 

((Clfdocalplacement)getLocalplacement()).setRelativePlacementLocation(location); 

} 

public  void  setAbsoluteLocation(Elfccartesianpoint  location)  { 
if  (location  ==  null)  return; 
if  (getLocalplacementO  ==  null)  return; 
if  (getLocalplacement().getPlacementrelto()  ==  null)  return; 

if  (getLocalplacementO. getPlacementrelto().islfcproduct() ==  SDAl.lang.LOGICAL.TRUE) 

setRelativeLocation(Clfccartesianpoint.delete(location,  getLocalplacement().getPlacementrelto().getlfcproduct().getAbsoluteLocation())); 
setRelativeLocation(location); 

} 

public  Elfccartesianpoint  getRelativeLocation()  { 
if  (getLocalplacementO  ==  null) return  null; 

return((Clfclocalplacement)getLocalplacement()).getRelativePlacementLocation(); 

} 

public  Elfccartesianpoint  getAbsoluteLocation()  { 
if  (getLocalplacementO  ==  null) return  null; 
if  (getLocalplacementO. getPlacementrelto() ==  null) return  null; 
if  (getLocalplacementO. getPlacementrelto().islfcproduct()  ==  SDAl.lang.LOGICAL.TRUE) 

return  Clfccartesiapoint.add(getLocalplacement().getPlacementrelto().getlfcproduct()-.getAbsoluteLocation(),  getRelativeLocation()); 
return  getRelativeLocation(); 

} 

//============================================================================================== 

//ANGLE  ROUTINES 

//============================================================================================= 

public  void  setRelativeAngle(double  angle)  { 
if  (getLocalplacementO  ==  null)  return; 

((Clfclocalplacement)getLocalplacement()).setRelativePlacementAngle(angle); 

} 

public  void  setAbsoluteAngle(double  angle)  { 
if  (getLocalplacementO  ==  nul1)  return; 
if  (getLocalplacement().getPlacementrelto()  ==  null)  return; 

if  (getLocalplacementO. getPlacementrelto().islfcproduct() ==  SDAl.lang.LOGICAL.TRUE) 

setRelativeAngle(angle  -  getLocalplacement().getPlacementrelto().getlfcproduct().getAbsoluteAngle()); 
setRelativeAngle(angle); 

} 

public  double  getRelativeAngle()  { 

if  (getLocalplacementO  ==  null)  return  0.0; 

return((Clfclocalplacement)getLocalplacement()).getRelativePlacementAngle(); 


} 
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public  double  getAbsoluteAngle()  { 

if  (getLocalplacement()  ==  null)  return  0.0; 

if  (getLocalplacement().getPlacementrelto()  ==  null)  return  0.0; 

if  (getLocalplacement().getPlacementrelto().islfcproduct()  ==  SDAl.lang.LOGICAL.TRUE) 

return(getLocalplacement().getPlacementrelto().getlfcproduct().getAbsoluteAngle()  +  getRelativeAngle()); 
return  getRelativeAngle(); 

} 


MDSProject,  MDSSite,  MDSBuilding,  and  MDSBuildingStorey 


These  classes  were  created  to  add  methods  to  support  accessors  for  higher  and 
lower  objects  in  the  hierarchy,  maintaining  the  object’s  program  (see  “MDSPro- 
gram,”  p  32),  additional  geometric  support,  inverse  relationships  (see  “Imple¬ 
ment  Inverse  Relationship  Attributes,”  p  28),  and  the  object’s  requirement  sets 
(see  “MDSRequirementSet,”  p  35).  A  typical  example  of  the  MDSProject  class  is: 


public  abstract  class  MDSProject 
extends  MDSObject 

implements  IntJnvContains,  lnt_MDSProgramContainer,  lnt_MDSProject,  lnt_MDSRequirementSetContainer  { 

II - 

II  these  methods  are  redefined  in  subclasses! 

public  Elfcaxis2placement  getAbsoluteplacement()  { 

System.out.println("MDSProject:getAbsoluteplacement,  SHOULD  NOT  BE  HERE!"); 
return  null; 


MDSProgram  m_program; 
public  MDSProject()  { 

m_program  =  new  MDSProgram(this); 

} 

11========================================================-. 

/**  Returns  a  Clfcsite  object.  7 
public  Clfcsite  getSitej)  { 

Vector  sites  =  getContainees(Clfcsite.class); 
if  (sites.size()  >  0)  { 

return(Clfcsite)sites.elementAt(0); 

} 

return  null; 

} 

11========================================================-. 

public  void  dump()  { 
super.dumpj); 

if  (m_contains  !=  null)  m_contains.dump(); 
if  (m_reqSetContainer  !=  null)  m_reqSetContainer.dump(); 
System.out.print("\tLocation:''); 
if  (getRelativeLocation()  !=  null)  { 

System.out.printf  Relative: "  +  getRelativeLocation()); 

} 

if  (getAbsoluteLocation()  !=  null)  { 

System.out.printf  Absolute: "  +  getAbsoluteLocation()); 

} 

System.out.printfV); 

System.out.printf\tAngle:"); 

System.out.printf  Relative: "  +  Double.toString(getRelativeAngle())); 
System.out.printf'  Absolute: "  +  Double.toString(getAbsoluteAngle())); 
System.out.print("\n”); 

} 

11============================================================== 

//dumpTolFC  Routine 


transient  private  boolean  dumpingTolFC  =  false; 

II  routine  to  dump  to  a  part  21  file  this  instance  and  any  attribute  object  variables 
public  void  dumpTolFC(SDAI.Iang.Model_contents  me)  { 
if  (dumpingTolFC)  return; 
dumpingTolFC  =  true; 

II  allow  MDSRequirementSetContainer  to  build  property  sets  for  requirement  sets  -  NEEDS  TO  BE  BEFORE  CALL  TO  SUPER! 
m_reqSetContainer.exportTolFC(); 

II  dump  parents 
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super.dumpTolFC(mc); 

if  (MDSIFCController.getlnstance().exportProgramlnfo)  { 

II  dump  program 

getProgram().exportTolFC(getGUID()  + "  Project  Program").dumpTolFC(mc); 

} 

dumpingTolFC  =  false; 

} 

//========================================================================= 

II  lnt_MDSProgramCortainer  IMPLEMENTATION 
//========================================================================= 

11===================================================================. 

public  MDSProgram  getProgramQ  { 
return  m_program; 

} 

11===================================================================. 

/**  Returns  null.  7 

public  MDSProgram  getParentProgram()  { 
return  null; 

} 

11===================================================================. 

/**  Returns  a  Vector  of  site  and  building  programs.  7 
public  Vector  getChildProgramsQ  { 

Vector  result  =  new  Vector)); 
if  (getSite))  ==  null)  { 
return  result; 

} 

result.addElement(getSite().getProgram()); 

Enumeration  buildings  =  getSite().getBuildings().elements(); 
while  (buildings.hasMoreElements())  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
result.addElement(building.getProgramQ); 

} 

return  result; 

} 

11===================================================================. 

public  double  getPlannedArea(MDSFunctionTemplate  template)  { 
return  getProgram().getPlannedArea(template); 

} 

public  double  getTotalPlannedArea(MDSFunctionTemplate  template)  { 
double  result  =  getPlannedArea(template); 
if  (getSite))  ==  null)  { 
return  result; 

} 

result  +=  getSite().getTotalPlannedArea(template); 

Enumeration  buildings  =  getSiteQ.getBuildingsQ.elementsQ; 
while  (buildings.hasMoreElements())  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
result  +=  building.getPlannedArea(template);  II  only  get  planned  (not  total) 
//result  +=  building.getTotalPlannedArea(template); 

} 

return  result; 

} 

11===================================================================. 

public  double  getPlacedArea()  { 

return  getProgramQ.getPlacedAreaQ; 

} 

public  double  getTotalPlacedArea()  { 
double  result  =  getPlacedAreaQ; 
if  (getSite()  ==  null)  { 
return  result; 

} 

result  +=  getSite().getTotalPlacedArea(); 

Enumeration  buildings  =  getSiteQ.getBuildingsQ.elementsQ; 
while  (buildings.hasMoreElements())  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
result  +=  building.getTotalPlacedAreaj); 

} 

return  result; 

} 

public  double  getPlacedArea(MDSFunctionTemplate  template)  { 
return  getProgram().getPlacedArea(template); 

} 

public  double  getTotalPlacedArea(MDSFunctionTemplate  template)  { 
double  result  =  getPlacedArea(template); 
if  (getSite()  ==  null)  { 
return  result; 


} 
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result  +=  getSite().getTotalPlacedArea(template); 

Enumeration  buildings  =  getSite().getBuildings().elements(); 
while  (buildings.hasMoreElementsO)  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
result  +=  building.getTotalPlacedArea(template); 

} 

return  result; 

} 

public  double  getPlacedArea(MDSFunctionlnstance  instance)  { 
return  getProgram().getPlacedArea(instance); 

} 

public  double  getTotalPlacedArea(MDSFunctionlnstance  instance)  { 
double  result  =  getPlacedArea(instance); 
if  (getSite()  ==  null)  { 
return  result; 

} 

result  +=  getSite().getTotalPlacedArea(instance); 

Enumeration  buildings  =  getSite().getBuildings().elements(); 
while  (buildings.hasMoreElementsO)  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
result  +=  building.getTotalPlacedArea(instance); 

} 

return  result; 

} 

II =================================================================== 

public  Vector  getFunctionlnstances(MDSFunctionTemplate  template)  { 
return  getProgram().getFunctionlnstances(template); 

} 

public  Vector  getTotalFunctionlnstances(MDSFunctionTemplate  template)! 

Vector  result  =  getFunctionlnstances(template); 
if  (getSite()  ==  null)  { 
return  result; 

} 

Enumeration  instances  =  getSite().getTotalFunctionlnstances(template).elements(); 
while  (instances.hasMoreElements())  { 

result.addElement(instances.nextElement()); 

} 

Enumeration  buildings  =  getSite().getBuildings().elements(); 
while  (buildings.hasMoreElementsO)  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
instances  =  building.getTotalFunctionlnstances(template).elements(); 
while  (instances.hasMoreElements())  { 

result.addElement(instances.nextElement()); 

} 

} 

return  result; 

} 

II =================================================================== 

public  Vector  getSpaces(MDSFunctionTemplate  template)  { 
return  getProgram().getSpaces(template); 

} 

public  Vector  getTotalSpaces(MDSFunctionTemplate  template)  { 

Vector  result  =  getSpaces(template); 
if  (getSite()  ==  null)  { 
return  result; 

} 

Enumeration  spaces  =  getSite().getTotalSpaces(template).elements(); 
while  (spaces.hasMoreElements())  { 

result.addElement(spaces.nextElementO); 

} 

Enumeration  buildings  =  getSite().getBuildings().elements(); 
while  (buildings.hasMoreElementsO)  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
spaces  =  building.getTotalSpaces(template).elements(); 
while  (spaces.hasMoreElements())  { 

result.addElement(spaces.nextElementO); 

} 

} 

return  result; 

} 

public  Vector  getSpaces(MDSFunctionlnstance  instance)  { 
return  getProgram().getSpaces(instance); 

} 

public  Vector  getTotalSpaces(MDSFunctionlnstance  instance)  { 

Vector  result  =  getSpaces(instance); 
if  (getSite()  ==  null)  { 
return  result; 
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} 

Enumeration  spaces  =  getSite().getTotalSpaces(instance).elements(); 
while  (spaces.hasMoreElementsO)  { 

result.addElement(spaces.nextElement()); 

} 

Enumeration  buildings  =  getSite().getBuildings().elements(); 
while  (buildings.hasMoreElementsO)  { 

MDSBuilding  building  =  (MDSBuilding)buildings.nextElement(); 
spaces  =  building.getTotalSpaces(instance).elements(); 
while  (spaces.hasMoreElementsO)  { 

result.addElement(spaces.nextElement()); 

} 

} 

return  result; 

} 

//================================================================================================= 

II  IntJnvContains  IMPLEMENTATION 

//================================================================================================= 

InvContains  m_contains  =  new  lnvContains(); 
public  final  Elfcrelcontains[]  getContains()  { 
return  m_contains.getContains(); 

} 

public  final  void  addContains(Elfcrelcontains  v)  { 
m_contains.addContains(v); 

} 

public  final  void  removeContains(Elfcrelcontains  v)  { 
m_contains.removeContains(v); 

} 

public  final  Elfcrelcontains  linkContainee(lnt_lnvlsContainedBy  containeeObj)  { 

Clfcrelcontains  link  =  MDSControllers.MDSObjectLinker.link_containerElementWithContaineeElement-((Elfcobject)this,  (Elfcobject)containeeObj); 

this.addContains(link); 

containeeObj.addlscontainedby(link); 

return  link; 

} 

public  final  Vector  unlinkContainee(lnt_lnvlsContainedBy  containeeObj)  { 
return  m_contains.unlinkContainee(containeeObj); 

} 

public  final  Vector  getContainees()  { 

return  m_contains.getContainees(); 

} 

public  final  Vector  getContainees(Class  containeeClass)  { 
return  m_contains.getContainees(containeeClass); 

} 

//================================================================================================= 

II  lnt_MDSProject  IMPLEMENTATION 

//============================================================================================= 

//============================================================================================= 

II  LOCATION  ROUTINES 

//============================================================================================= 

public  void  setRelativeLocation(Elfccartesianpoint  location)  { 
if  (getAbsoluteplacement()  !=  null) 

((Clfcaxis2placement)getAbsoluteplacement()).setAxisLocation(location); 

} 

public  void  setAbsoluteLocation(Elfccartesianpoint  location)  { 
setRelativeLocation(location); 

} 

public  Elfccartesianpoint  getRelativeLocation()  { 
if  (getAbsoluteplacement()  !=  null) 

return((Clfcaxis2placement)getAbsoluteplacement()).getAxisLocation(); 
return  null; 

} 

public  Elfccartesianpoint  getAbsoluteLocationQ  { 
return  getRelativeLocationQ; 

} 

//================================================================================================= 

//ANGLE  ROUTINES 

//================================================================================================= 

public  void  setRelativeAngle(double  angle)  { 
if  (getAbsoluteplacement()  !=  null) 

((Clfcaxis2placement)getAbsoluteplacement()).setReferenceAngle(angle); 

} 

public  void  setAbsoluteAngle(double  angle)  { 
setRelativeAngle(angle); 

} 

public  double  getRelativeAngle()  { 

if  (getAbsoluteplacementj)  !=  null) 

return((Clfcaxis2placement)getAbsoluteplacement()).getReferenceAngle(); 
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return  0.0; 

} 

public  double  getAbsoluteAngleQ  { 
return  getRelativeAngle(); 

} 

//========================================= 

II  lnt_MDSRequirementSetContainer  IMPLEMENTATION 


MDSRequirementSetContainer  m_reqSetContainer  =  new  MDSRequirementSetContainer(this); 

public  void  addRequirementSet(MDSRequirementSet  requirementSet)  { 
m_reqSetContainer.addRequirementSet(requirementSet); 

} 

public  boolean  removeRequirementSet(MDSRequirementSet  requirementSet)  { 
return  m_reqSetContainer.removeRequirementSet(requirementSet); 

} 

public  void  removeAHRequirementSetsO  { 

m_reqSetContainer.removeAIIRequirementSets(); 

} 

public  Vector  getRequirementSetsQ  { 

return  m_reqSetContainer.getRequirementSets(); 

} 

public  MDSRequirementSetfindRequirementSet(String  requirementSetName)  { 
return  m_reqSetContainer.findRequirementSet(requirementSetName); 

} 

} 


Implement  Inverse  Relationship  Attributes 


Several  class  attributes  defined  in  the  EXPRESS  file  are  for  “Inverse”  relation¬ 
ships.  For  example,  object  IfcBuilding  is  defined  in  EXPRESS  as: 

ENTITY  IfcBuilding 
SUBTYPE  OF  (IfcProduct); 

GenericType  :  IfcBuildingTypeEnum; 
calcTotalHeight  :  OPTIONAL  IfcLengthMeasure; 
calcSiteCoverage :  OPTIONAL  IfcAreaMeasure; 
calcTotalVolume  :  OPTIONAL  IfcVolumeMeasure; 

INVERSE 

Contains  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatingObject; 

IsContainedBy  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatedObjects; 

ServicedBySystems:  SET  [0:?]  OF  IfcRelServicesBuildings  FOR  RelatedObjects; 

END_ENTITY; 


The  three  inverse  attributes — “Contains,”  “IsContainedBy,”  and  “ServicedBySys¬ 
tems” — are  not  implemented  in  the  new  object  model.  Inverse  attributes  imply  a 
reference  from  one  object  to  another.  In  this  case,  there  should  be  a  reference 
from  a  IfcRelContains  object  to  a  IfcBuilding  object  using  the  RelatingObject  at¬ 
tribute  from  IfcRelContains.  This  implied  attribute  should  be  named  Contains. 
These  are  two  other  implied  references  named  IsContainedBy  and  ServicedBy¬ 
Systems.  Figure  4  illustrates  this  concept.  In  this  example,  the  implied  refer¬ 
ences  from  the  Building  object  and  the  Story  object  to  the  RelContains  object  are 
not  generated. 


To  implement  some  of  these  implied  references,  three  new  custom  classes  were 
created:  InvConnectedToFrom  (interface  Int_InvConnectedToFrom),  InvCon- 
tains  (interface  Int_InvContains),  and  InvContainedBy  (interface 
Int_InvContainedBy).  In  addition  to  these  classes,  a  helper  class  MDSObject- 
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Linker  was  created.  This  class  provided  methods  used  by  the  custom  classes  to 
help  query  the  database  and  filter  results  from  relationship  objects.  Instances  of 
InvConnectedToFrom,  InvContains,  or  InvContainedBy  are  created  in  appropri¬ 
ate  classes  to  delegate  the  responsibility  of  maintaining  these  inverse  relation¬ 
ships.  Figure  5  shows  this  situation  for  a  site,  building,  and  story  and  how  they 
are  related  through  instances  of  the  Ifcrelcontains  class. 
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Figure  4.  The  three  inverse  attributes:  “Contains,”  “IsContainedBy,”  and  “ServicedBySystems. 
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Figure  5.  How  a  site,  building,  and  story  are  related  through  instances  of  the  Ifcrelcontains  class. 
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The  following  code  example  shows  how  instances  of  InvContains  and  InvCon- 
tainedBy  are  created  and  delegated  to  in  MDSBuilding  (the  parent  of  Clfcbuild- 
ing): 

public  abstract  class  MDSBuilding 
extends  MDSProduct 

implements  IntJnvContains,  IntJnvisContainedBy  { 

//==================================================================================== 

II  IntJnvContains  IMPLEMENTATION 

//================================================================================== 

InvContains  m_contains  =  new  lnvContains(); 

public  final  Elfcrelcontains[]  getContains()  { 
return  m_contains.getContains(); 

} 

public  final  void  addContains(Elfcrelcontains  v)  { 
m_contains.addContains(v); 

} 

public  final  void  removeContains(Elfcrelcontains  v)  { 
m_contains.removeContains(v); 

} 

public  final  Clfcrelcontains  HnkContainee(lnt_lnvlsContainedBy  containeeObj)  { 

Clfcrelcontains  link  = 

MDSObjectLinker.link_containerElementWithContaineeElement((Elfcobject)this,  (Elfcobject)containeeObj); 
this.addContains(link); 
containeeObj.addlscontainedby(link); 
return  link; 

} 

public  final  Vector  unlinkContainee(lnt_lnvlsContainedBy  containeeObj)  { 
return  m_contains.unlinkContainee(containeeObj); 

} 

public  final  Vector  getContainees()  { 

return  m_contains.getContainees(); 

} 

public  final  Vector  getContainees(Class  containeeClass)  { 
return  m_contains.getContainees(containeeClass); 

} 

//=================================================================================== 

II  IntJnvisContainedBy  IMPLEMENTATION 

//=================================================================================== 

InvIsContainedBy  mJsContainedBy  =  new  lnvlsContainedBy(); 

public  final  Elfcrelcontains[]  getlscontainedby()  { 
return  mJsContainedBy  ,getlscontainedby(); 

} 

public  final  void  addlscontainedby(Elfcrelcontains  v)  { 
mJsContainedBy.addlscontainedby(v); 

} 

public  final  void  removelscontainedby(Elfcrelcontains  v)  { 
mJsContainedBy.removelscontainedby(v); 

} 

public  final  Clfcrelcontains  HnkContainer(lntJ nvContains  containerObj)  { 

Clfcrelcontains  link  = 

MDSObjectLinker.link_containerElementWithContaineeElement((Elfcobject)containerObj,  (Elfcobject)this); 
containerObj.  addContains(link); 
this.addlscontainedby(link); 
return  link; 

} 

public  final  Vector  unlinkContainerjlntJ nvContains  containerObj)  { 
return  mJsContainedBy.unlinkContainer(containerObj); 

} 

public  final  Vector  getContainers()  { 

return  mJsContainedBy ,getContainers(); 

} 

public  final  Vector  getContainers(Class  containerClass)  { 

return  mJsContainedBy .getContainers(containerClass); 

} 

} 


Through  the  use  of  these  classes,  objects  can  set  up  the  inverse  relationships  be¬ 
tween  other  objects. 
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Add  New  Classes 

Next  was  the  creation  of  several  custom  classes  to  add  functionality  to  the  object 
model.  These  classes  would  support  the  functionality  that  was  not  in  the  IFC 
model,  but  that  were  required  to  support  the  Building  Composer  application: 
MDSActivity,  MDSFunction,  MDSFunctionTemplate,  MDSFunctionlnstance, 
MDSProgram  (helper  interface  Int_ProgramContainer),  MDSProperty,  MDSRe- 
quirement,  MDSAttribute,  and  MDSRequirementSet  (helper  class  MDSRe- 
quirementSetContainer  and  interface  Int_MDSRequirement-SetContainer).  An 
important  concern  of  these  new  classes  was  determining  how  to  output  these 
classes  and  their  data  in  an  IFC  output  file  (or  if  it  should  be).  The  dumpToIFC 
method  defined  in  the  MDSAppInst  class  had  be  overridden  in  most  of  the  fol¬ 
lowing  classes  to  address  this  concern. 

MDSFunction,  MDSFunctionTemplate,  and  MDSFunctionlnstance 

The  creation  of  these  classes  was  necessary  because  the  IFC  model  did  not  ade¬ 
quately  represent  the  concept  of  a  template  (or  set  of  default  values)  for  a  func¬ 
tional  area.  This  template  would  be  added  to  the  project  and  would  then  be  used 
for  the  creation  of  function  instances.  The  function  template  is  a  local  project 
copy  of  function  templates  defined  in  an  external  database.  Requirement  values 
from  the  template  are  used  as  the  default  values  during  the  creation  of  a 
function  instance.  Following  the  creation  of  function  instances,  spaces  are 
created  from  the  function  instance.  An  important  concept  is  that  there  is  only 
one  function  template  within  the  project,  but  there  can  be  many  function 
instances  that  were  created  from  that  function  template  (Figure  6). 

A  function  can  also  establish  relations  to  other  functions.  The  first  type  of  rela¬ 
tionship  is  a  parent/child  relationship.  In  this  relationship  one  function,  the 
parent,  is  specialized  or  refined  in  another  function,  the  child.  An  example  of 
this  would  be  the  definition  of  an  office  function  and  the  specialization  in  a  pri¬ 
vate  office  function. 


Figure  6.  Relation  between  MDSFunction,  MDSFunctionTemplate,  and  MDSFunctionlnstance. 
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The  second  type  of  relationship  is  a  super/sub  relationship.  In  this  relationship 
one  function  contains  another  function.  This  relationship  allows  for  a  grouping 
of  functions  into  a  common  entity  for  assignment  to  a  space.  An  example  of  this 
would  be  the  definition  of  a  lobby  function,  the  super,  that  would  contain  a  recep¬ 
tion,  waiting,  and  display  functional  area,  the  subs. 

Though  these  relationships  are  coded  in  the  object  model,  they  are  not  fully 
tested  and  cannot  be  accessed  through  the  Building  Composer  core  library.  Fur¬ 
ther  testing  and  analysis  of  these  relationships  is  needed. 

MDSProgram 

The  MDSProgram  class  is  used  to  associate  MDSFunctionTemplate  and 
MDSFunctionlnstance  objects  with  an  MDSProject,  MDSSite,  MDSBuilding,  or 
MDSBuildingStorey  object  (its  container  object).  These  objects  can  have  a  pro¬ 
gram  of  function  templates,  with  a  planned  area,  entered  by  the  user  and  then 
related  to  a  set  of  function  instances. 

To  allow  multiple  objects  to  reference  the  same  function  template,  but  have  indi¬ 
vidual  planned  areas,  a  hashtable  was  used  within  MDSProgram.  This 
hashtable  would  have  the  function  template  as  a  key  and  then  an  instance  of  the 
helper  class  MDSFunctionAreaAndSpace  as  the  value.  The  class  MDSFunc- 
tionAreaAndSpace  would  maintain  the  planned  area  for  that  linkage  and  also 
have  a  hashtable.  This  hashtable  would  have  the  function  instance  as  a  key  and 
then  a  vector  of  spaces  as  the  key. 

In  Figure  7,  a  site,  “Site  1,”  and  story,  “Story  1,”  objects  are  shown  with  their 
program  objects.  There  are  also  two  function  templates  available,  “Function 
Template  1”  and  “Function  Template  2.”  From  the  diagram,  it  can  be  seen  that 
the  site  program  hashtable  has  a  reference  to  “Function  Template  1”  and  that 
there  is  a  planned  area  of  1000.  This  reference  has  one  function  instance,  “In¬ 
stance  1,”  and  two  spaces,  “Space  1”  and  “Space  2.”  The  story  program  hashtable 
has  a  reference  to  “Function  Template  1”  and  “Function  Template  2.”  The  refer¬ 
ence  to  “Function  Template  1”  has  a  planned  area  of  800.  This  reference  has  one 
function  instance,  “Instance  2,”  and  one  space,  “Space  3.”  The  reference  to  “Func¬ 
tion  Template  2”  has  a  planned  area  of  500.  This  reference  has  two  function  in¬ 
stances:  “Instance  3”  has  two  spaces,  “Space  5”  and  “Space  6,”  and  “Instance  4” 
has  one  space,  “Space  4.” 
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The  MDSProgram  class  contains  methods  to  add/remove  function  templates, 
add/remove  function  instances,  add/remove  spaces,  and  setting  planned  area  for 
a  function  template.  Some  methods  from  the  MDSProgram  class  are: 

public  class  MDSProgram  extends  MDSAppInst  { 

11========================================================================= 

public  void  addFunctionTemplate(MDSFunctionTemplate  template)  { 
public  boolean  removeFunctionTemplate(MDSFunctionTemplate  template)  { 
public  Vector  getFunctionTemplatesQ  { 

public  MDSFunctionTemplate  findFunctionTemplate(String  functionTemplateName)  { 
11========================================================================= 

public  void  addFunctionlnstance(MDSFunctionlnstance  instance)  { 
public  boolean  removeFunctionlnstance(MDSFunctionlnstance  instance)  { 
public  Vector  getFunctionlnstances()  { 

public  Vector  getFunctionlnstances(MDSFunctionTemplate  template)  { 
11========================================================================= 

public  void  setPlannedArea(MDSFunctionTemplate  template,  double  plannedArea)  { 
public  double  getPlannedArea(MDSFunctionTemplate  template)  { 
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//======================================================== 

public  void  addSpace(MDSFunctionlnstance  instance,  MDSSpace  space)  { 
public  boolean  removeSpace(MDSSpace  space)  { 
public  Vector  getSpaces(MDSFunctionTemplate  template)  { 
public  Vector  getSpaces(MDSFunctionlnstance  instance)  { 


The  object  that  would  contain  the  MDSProgram  instance  would  then  implement 
the  Int_MDSProgramContainer  interface.  This  interface  defined  several  meth¬ 
ods  to  allow  an  object  to  get  its  program,  planned  areas,  placed  areas,  function 
instances,  and  spaces. 


MDSProperty,  MDSRequirement,  and  MDSAttribute 

The  creation  of  these  classes  was  for  the  storage  and  maintaining  of  attributes 
related  to  object  properties.  An  object  can  have  associated  property  values  at¬ 
tached.  These  values  have  a  datatype,  value,  unit  of  measure,  and  other  attrib¬ 
utes  with  them.  Figure  8  shows  the  relationship  between  these  classes. 


The  base  MDSProperty  class  defines  most  of  the  attributes  and  functionality  of 
these  classes.  Most  of  the  attributes  are  self-explanatory,  but  the  following  de¬ 
scribe  some  of  the  others: 


DataType 

Uom 

Source 

Comment 


The  datatype  for  the  value.  Possible  values:  1  =  string, 

2  =  double,  3  =  integer,  4  =  Boolean. 

The  unit  of  measure  for  the  value,  i.e.,  inches,  square  feet. 

The  justification  for  the  default  value. 

A  user  editable  field  that  indicates  the  reason  the  user  entered  a 
specific  value. 


Figure  8.  Relationship  between  MDSProperty,  MDSRequirement,  and  MDSAttribute  classes. 
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Typically  an  MDSRequirement  object  is  created  and  added  to  an  object,  either  a 
project,  site,  building,  story,  function,  or  space.  The  MDSAttribute  object  is  used 
at  certain  times  with  a  space  object.  A  space  object  “inherits”  the  properties  of 
the  function  instance  that  defines  it.  For  example,  if  the  function  instance  has  a 
property  “wallColor”  with  a  value  of  “blue,”  then  the  space  should  have  that 
property  as  well.  If  the  function  instance  changed  the  value  from  “blue”  to  “red” 
then  the  new  value  should  be  displayed  in  all  spaces  of  that  function  instance 
type.  However,  the  space  should  be  able  to  override  that  value  if  desired.  To  ac¬ 
complish  this,  the  property  “wallColor”  from  the  function  instance  is  created  on 
the  space  object  as  an  MDSAttribute  object.  The  proxy  attribute  for  this  object 
would  then  reference  the  MDSRequirement  object  on  the  function  instance.  All 
interactions  with  the  MDSAttribute  object  then  call  the  proxy  object  for  comple¬ 
tion.  However,  when  a  value  change  is  attempted  on  the  MDSAttribute  object, 
the  reference  to  the  proxy  object  is  removed  and  the  MDSAttribute  object  deals 
with  all  interactions  directly. 

MDSRequirementSet 

The  MDSRequirementSet  class  is  used  to  store  the  MDSRequirement  instances 
related  to  an  object.  An  MDSRequirementSet  object  has  a  tab  name  attribute 
that  is  used  to  specify  which  tab  the  set  should  be  displayed  on.  The  helper  class 
MDSRequirementSetContainer  was  created  to  assist  in  the  relationship  between 
an  object  and  an  MDSRequirementSet  object.  The  MDSRequirementSetCon¬ 
tainer  class  is  used  in  the  delegation  design  pattern  with  other  objects. 


Database  Interface 

To  provide  an  independent  view  to  the  database  being  used  for  persistent  storage 
of  the  object  model,  an  interface  was  defined:  Int_MDSDatabase.  Through  the 
definition  of  an  independent  interface,  several  different  backend  database  sys¬ 
tems  could  be  programmed  for  use.  This  interface  defines  the  methods  required 
for  a  database.  These  methods  can  be  grouped  into  opening  and  closing  the  da¬ 
tabase,  transaction  management,  root  methods,  bind  methods,  migrate  object, 
destroy  object,  and  enumeration  of  objects. 

The  opening  and  closing  methods  are: 

/**  Opens  data  storage.  Will  create  database  if  it  does  not  exist.  Will  open  database  in  update  mode.  7 
public  int  openDatabase(String  name); 

/**  Closes  data  storage.  */ 

public  boolean  closeDatabase(); 

/**  Returns  true  if  database  has  been  opened.  7 
public  boolean  isDatabaseOpenQ; 
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/**  Gets  name  of  current  database.  7 
public  String  getDatabaseNameQ; 


The  transaction  management  methods  are: 

/**  Returns  if  a  transaction  is  in  progress.  7 
public  boolean  transactionlnProgress(); 

/** 

*  Returns  transaction  type. 

*  1  =  read  only 

*  2  =  update 

*  -1  =  no  current  transaction 

*  -999  =  error 
7 

public  int  transactionType(); 

/**  Starts  an  update  transaction.  7 

public  boolean  startUpdateT ransaction(); 

/**  Starts  a  read-only  transaction.  7 

public  boolean  startReadOnlyTransaction(); 

/**  Commits  the  current  transaction.  7 
public  boolean  commitTransactionQ; 

/**  Aborts  the  current  transaction.  7 
public  boolean  abortT ransactionQ; 


The  root  methods  are: 


/**  Creates  a  root  object  with  the  given  name  if  it  doesn't  exist.  The  root  object  is  a  Vector  object.  7 
public  boolean  createRoot(String  name); 

/**  Deletes  a  root  object  with  the  given  name  if  it  exists.  7 
public  boolean  deleteRoot(String  name); 

/**  Gets  the  root  object  for  name  given.  The  root  object  is  a  Vector  object.  7 
public  Vector  getRoot(String  name); 

/**  Adds  an  object  to  the  root  object  for  name  given.  The  root  object  is  a  Vector  object.  7 
public  boolean  addToRoot(String  name,  Object  obj); 


A  root  is  a  concept  common  in  many  object-oriented  databases.  A  root  is  a  refer¬ 
ence  to  an  individual  object  within  the  database,  an  entry  point.  At  least  one 
root  object  is  needed  in  a  database.  A  single  root  can  be  sufficient,  but  it  may  be 
more  efficient  to  have  more.  In  general,  every  object  in  the  database  should  not 
be  associated  with  a  root.  This  is  bad  for  performance.  Each  root  refers  to  ex¬ 
actly  one  object. 


The  bind  methods  are: 

/** 

*  Binds  an  object  in  the  database  with  the  given  name.  The  object  can  later  be 

*  retrieved  with  method  getBoundObject. 

*  Aborts  transaction  if  exception! 

* 

*  @param  obj  =  Object  to  bind  in  database. 

*  @param  name  =  String  for  bound  object. 

7 

public  boolean  bindObject(Object  obj,  String  name); 

/** 

*  Unbinds  object  with  the  given  name. 

*  Aborts  transaction  if  exception! 

*  @param  name  =  String  of  bound  object. 

7 

public  boolean  unbindObject(String  name); 

/** 

*  Gets  the  bound  object  with  the  given  name. 

*  Aborts  transaction  if  exception! 

* 

*  @param  name  =  String  of  bound  object  to  search  for. 

*  @return  Object  with  bound  name;  null  otherwise. 


ERDC/CERL  TR-02-28 


37 


*/ 

public  Object  getBoundObject(String  name); 

/** 

*  Checks  for  a  bound  object  with  the  given  name. 

*  Does  NOT  abort  transaction  if  exception! 

*  @param  name  =  String  of  bound  object  to  check  for. 
*/ 

public  boolean  checkBoundObject(String  name); 


The  migrate  method  is: 

/** 

*  Migrates  the  given  object  to  the  database.  The  object  must  be  persistent-capable. 

* 

*  @param  obj  =  Object  to  migrate  to  database. 

*/ 

public  boolean  migrateObject(Object  obj); 


The  destroy  method  is: 

/** 

*  Destroys  the  given  object  from  the  database. 

*  The  user  is  responsible  for  making  sure  all  references  to  the  destroyed  object  are  cleaned  up. 

* 

*  @param  obj  =  Object  to  destroy  in  database. 

*/ 

public  boolean  destroyObject(Object  obj); 


The  all  object  enumeration  methods  are: 

/** 

*  Populates  Vector  with  all  objects  in  the  database.  Does  not  return  'java'  package  objects. 

*  If  'java'  objects  desired,  use  allObjects(Vector  vec,  String  name)  with  'java'  parameter. 

* 

*  @param  vec  =  Vector  that  will  be  populated.  This  should  be  created  by  calling  method. 
*/ 

public  boolean  allObjects(Vector  vec); 

/** 

*  Populates  Vector  with  all  objects  in  the  database  that  'islnstance'  for  the  Class  given. 

* 

*  @param  vec  =  Vector  that  will  be  populated.  This  should  be  created  by  calling  method. 

*  @param  compareClass  =  Class  to  comapre  to. 

*/ 

public  boolean  allObjects(Vector  vec,  Class  compareClass); 


There  are  two  classes  created  that  implement  this  interface,  MDSLocalDb  and 
MDSNoDb.  The  MDSLocalDb  class  is  for  use  with  the  ObjectStore  PSE  Pro  da¬ 
tabase.  The  MDSNoDb  class  will  not  save  any  objects  persistently.  All  data  is 
maintained  in  memory  and  lost  when  the  application  ends. 


Controller  and  Helper  Classes 

In  an  effort  to  try  and  make  the  object  model  easier  to  use,  several  additional 
classes  were  created.  The  first  of  these  were  the  controller  classes. 

The  controller  classes  consist  of  MDSModelController,  MDSProjectController, 
MDSObjectLinker,  and  MDSIFCController. 
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The  helper  classes  consist  of  Int_MDSDumpToIFC  and  MDSObjectExtents. 


MDSModelController 


The  MDSModelController  class  is  responsible  for  starting,  initializing,  and  stop¬ 
ping  a  session  with  the  object  model.  A  session  creates  a  context  in  which  you 
can  create  transactions,  access  a  database,  and  manipulate  persistent  objects 
within  the  object-oriented  database.  This  controller  maintains  a  variable  that 
points  to  the  database  server  that  the  application  has  created. 


During  start  of  the  session,  this  controller  attempts  to  startup,  login,  and  open 
the  database  server. 


MDSProjectController 


The  MDSProjectController  class  was  created  to  help  traversing  the  major  ele¬ 
ments  of  a  project  easier.  These  elements  are  Clfcproject,  Clfcsite,  Clfcbuilding, 
and  Clfcbuildingstorey.  This  controller  maintains  the  concept  of  a  current  ele¬ 
ment,  set/get  of  the  current  element,  and  ability  to  get  the  next  type  of  element 
in  line  (get  the  building  elements  from  a  site  element).  One  important  aspect  of 
this  controller  is  that  it  sets  the  project  element  to  be  a  root  object  that  can  later 
be  retrieved  (see  section  “Database  Interface”  above  about  root  objects). 

/** 

*  Adds  a  Clfcproject  to  the  database  (if  one  doesn't  already  exist). 

*  The  new  project  is  made  the  current  project. 

*/ 

public  boolean  addProject()  { 
boolean  result  =  false; 
if  (projectExists()  ==  true)  return  result; 
m_database.startllpdateTransaction(); 

if  (m_database.addToRoot(PROJECT_ROOT_NAME,  new  Clfcproject(new  doublej]  {0,  0,  0}))  ==  true)  { 
setCurrentProject(); 
result  =  true; 

} 

m_database.commitTransaction(); 
return  result; 

} 


MDS  ObjectLinker 


The  MDSObjectLinker  controller  is  a  class  that  is  used  to  help  implement  the 
inverse  relationship  attributes  (see  section  “Implement  Inverse  Relationship  At¬ 
tributes”  above).  It  contains  many  methods  that  help  create  and  access  both 
sides  of  the  one-to-one  and  one-to-many  relationships. 
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PSE  Post-processing 

Once  the  object  model  classes  have  been  setup,  the  next  step  is  to  prepare  them 
for  persistent  storage  within  the  object-oriented  database.  The  database  used  is 
Objectstore  Personal  Storage  Edition  (PSE)  Pro  from  Excelon  Corp.  PSE  uses  a 
post-processor  to  modify  classes  to  make  them  persistent  capable;  i.e.,  so  they 
can  be  stored  within  the  database.  All  classes  from  the  object  model  must  be  run 
through  this  post-processor. 

In  addition,  two  custom  classes  were  created  that  “wrap”  persistent  versions  of  a 
Hashtable  and  Vector  supplied  with  PSE.  These  two  classes  are  MDSHashtable 
and  MDSVector. 

The  complete  listing  of  the  batch  file  used  is  in  Appendix  D.  However,  the  main 
emphasis  is  that  the  process  requires  several  steps  that  must  be  executed  in  or¬ 
der.  The  first  step  is  to  make  the  Capp_inst  class  persistent.  This  class  contains 
two  fields  that  do  not  need  to  be  stored  persistently.  This  is  the  reason  for  the 
“-tf”  option.  The  second  step  is  a  normal  post-processing  of  all  classes  within  the 
object  model.  The  third  step  is  to  make  certain  helper  classes  generated  from 
StepTools  persistent  aware.  This  is  the  reason  for  the  “-pa”  option.  The  final 
step  is  to  make  the  controller  classes  persistent  aware. 


Object  Model  Use 


There  are  several  ways  in  which  the  object  model  can  be  used.  The  most  basic 
way  is  through  a  simple  Java  method  that  creates  and  manipulates  the  objects. 
This  approach,  however,  would  provide  no  persistent  storage  of  the  objects  cre¬ 
ated.  To  persist  objects  to  the  database,  a  transaction  must  be  started,  objects 
created,  objects  added  to  the  database  or  referred  to  by  an  object  already  in  the 
database,  and  then  the  transaction  closed.  Here  is  an  example: 

public  class  test  { 

public  static  void  main(String[]  args)  { 

try  { 

II  Create/Initialize  database  server 

MDSLocalDb  mainDatabaseServer  =  new  MDSLocalDbQ; 

mainDatabaseServer.startup(); 

mainDatabaseServer.loginf'j-heckel"); 

mainDatabaseServer.openDatabase(''testDb.odb"); 

mainDatabaseServer.startUpdateTransaction(); 

II  Create  instances 

Clfcownerhistory  owner  =  new  Clfcownerhistory(); 
mainDatabaseServer.migrateObject(owner); 
owner.setOwnerdescriptorfJeff  Heckel'1); 
owner.setApplicationidfSDAITestApplication"); 

Clfcpropertytypedef  propDef  =  new  ClfcpropertytypedefQ; 
mainDatabaseServer.migrateObject(propDef); 
doubleO  tempi  =  {0.,  0.,  1. }; 

Clfcdirection  axis  =  new  Clfcdirection(); 
mainDatabaseServer.migrateObject(axis); 
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axis.setDirectionratios(temp1 ); 
doublefl  temp2  =  { 1.,  0.,  0. }; 

Clfcdirection  refDir  =  new  Clfcdirection(); 
mainDatabaseServer.migrateObject(refDir); 
refDir.setDirectionratios(temp2); 
doublefl  temp3  =  { 10.,  10.,  0. }; 

Clfccartesianpoint  point  =  new  Clfccartesianpoint(); 

mainDatabaseServer.migrateObject(point); 

point.setCoordinates(temp3); 

Clfcaxis2placement3d  axisl  =  new  Clfcaxis2placement3d(); 

mainDatabaseServer.migrateObject(axisl); 

axisl  setLocation(point); 

axisl  setAxis(axis); 

axisl  .setRefdirection(refDir); 

Clfcaxis2placement  axis2  =  new  Clfcaxis2placement(); 
mainDatabaseServer.migrateObject(axis2); 
axis2.setlfcaxis2placement3d(axis1 ); 

Clfclocalplacement  place  =  new  Clfclocalplacement(); 

mainDatabaseServer.migrateObject(place); 

place.setRelativeplacement(axis2); 

Clfcwall  walll  =  new  Clfcwall(); 

mainDatabaseServer.migrateObject(walll); 

walll  .setOwnerhistory(owner); 

walll.  setProjectidfwalU"); 

walll  .setLocalplacement(place); 

mainDatabaseServer.commitTransaction(); 

mainDatabaseServer.closeDatabase(); 

} 

catch  (Exception  e)  { 

e .  p  ri  ntStackT  race() ; 

} 

} 

} 


This  example  migrates  each  object  to  the  database  as  created.  The  problem  with 
this,  however,  is  that  there  is  no  way  to  later  retrieve  these  objects  from  a  single 
starting  point.  As  mentioned  about  database  roots  above  (see  “Database  Inter¬ 
face,”  p  35),  a  root  links  a  string  value  with  an  object  so  that  it  can  later  be  re¬ 
trieved.  A  better  approach  would  be: 


public  class  test  { 

public  static  void  main(String[]  args)  { 

try  ( 


II  Create/Initialize  database  server 

MDSLocalDb  mainDatabaseServer  =  new  MDSLocalDb(); 

mainDatabaseServer.startup(); 

mainDatabaseServer.loginf'j-heckel"); 

mainDatabaseServer.openDatabasef'testDb.odb"); 

mainDatabaseServer.startUpdateTransaction(); 

II  Create  instances 

Clfcownerhistory  owner  =  new  Clfcownerhistory(); 
owner.setOwnerdescriptorfJeff  Heckel'1); 
owner.setApplicationidf'SDAITestApplication"); 
Clfcpropertytypedef  propDef  =  new  ClfcpropertytypedefQ; 
doublefl  tempi  =  (0.,  0.,  1. }; 

Clfcdirection  axis  =  new  ClfcdirectionQ; 
axis.setDirectionratios(temp1 ); 
doublefl  temp2  =  { 1.,  0.,  0. }; 

Clfcdirection  refDir  =  new  ClfcdirectionQ; 
refDir.setDirectionratios(temp2); 
doublefl  temp3  =  { 10.,  10.,  0. }; 

Clfccartesianpoint  point  =  new  Clfccartesianpoint(); 
point.setCoordinates(temp3); 

Clfcaxis2placement3d  axisl  =  new  Clfcaxis2placement3d(); 

axisl. setLocation(point); 

axisl.  setAxis(axis); 

axisl  .setRefdirection(refDir); 

Clfcaxis2placement  axis2  =  new  Clfcaxis2placement(); 
axis2.setlfcaxis2placement3d(axis1); 

Clfclocalplacement  place  =  new  ClfclocalplacementQ; 
place.setRelativeplacement(axis2); 
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Clfcwall  walll  =  new  Clfcwall(); 

mainDatabaseServer.bindObject(wall1,  "Walll"); 

walll  .setOwnerhistory(owner); 

walll.  setProjectid("wall1"); 

walll  .setLocalplacement(place); 

mainDatabaseServer.commitTransaction(); 

mainDatabaseServer.closeDatabase(); 

} 

catch  (Exception  e)  { 

e.printStackTrace(); 

} 

} 

} 


The  difference  here  is  that  the  wall  object  is  bound  to  the  string  “Walll.”  Since 
the  wall  object  contains  references  (either  directly  or  indirectly)  to  all  other  ob¬ 
jects  created,  these  objects  will  be  added  to  the  database  when  the  wall  object  is 
persisted  to  the  database.  This  is  called  transitive  persistence.  Later  the  wall 
object  can  be  retrieved  with  the  call: 


Object  obj  =  mainDatabaseServer.getBoundObjectfWalU"); 
if  (obj  instanceof  Clfcwall)  { 

Clfcwall  walll  =  (Clfcwall)obj; 

} 


The  following  shows  a  simplified  example  more  closely  related  to  how  a  user 
would  interact  with  the  object  model.  It  uses  the  controller  classes  to  do  some  of 
its  interactions: 

II  declaration 

MDSLocalDb  mainDatabaseServer; 

MDSModelController  mdlCtl; 

MDSProjectController  prjCtl; 

II  create  database  server 
mainDatabaseServer  =  new  MDSLocalDb(); 

II  create  controllers 

mdlCtl  =  new  MDSModelController(mainDatabaseServer); 
prjCtl  =  mdlCtl.  getProjectController(); 

II  start  session  and  initialize  controllers 

try  { 

if  (mdlCtl.startSession(dbName,  "BuildingComposer")  ==  0)  { 

errorMessagefOpen  Database  ErrorAnError  starting  session!"); 
return; 

} 

if  (mdlCtl. InitQ  ==  false)  { 

errorMessagefOpen  Database  ErrorAnError  initializing  controllers!"); 
return; 

} 

} 

catch  (Exception  e)  { 

errorMessagefError  starting  session  and  initializing  controllers:"); 

errorMessage(e); 

return; 

} 

II  get  project,  if  does  not  exist  create  it 
Clfcproject  project  =  prjCtl. getCurrentProject(); 
if  (project  ==  null)  { 

if  (iprjCtl.addProjectO)  { 

errorMessagefUnable  to  add  Project!"); 
return  false; 

} 

project  =  prjCtl.getCurrentProjectQ; 

} 

if  (project  ==  null)  return  false; 

II  get  site,  if  does  not  exist  create  it 
Clfcsite  site  =  prjCtl.getCurrentSiteQ; 
if  (site  ==  null)  { 
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if  (!prjCtl.addSite())  { 

errorMessagefllnable  to  add  Site!"); 
return  false; 

} 

site  =  prjCtl.getCurrentSite(); 

} 

if  (site  ==  null)  return  false; 

II  start  an  update  transaction,  create  elements,  and  close  transaction 
mainDatabaseServer.startUpdateTransaction(); 

Clfcownerhistory  history  =  new  ClfcownerhistoryQ 
history.setOwnerdescriptorf'The  Main  Application"); 
project.setOwnerhistory(history); 
mainDatabaseServer.commitTransaction(); 

II  stop  session 

if  (mdlCtl.isSessionStarted())  { 
mdlCtl.stopSessionQ; 

} 
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4  Building  Composer  Core  Library 


The  Building  Composer  core  library  is  separated  into  several  packages  to  help 
isolate  code  and  make  it  more  reusable  for  final  application  development.  This 
core  library  is  used  by  the  Criteria  Composer  application  to  provide  most  of  its 
functionality  and  graphical  elements.  This  core  library  was  also  used  in  the  de¬ 
velopment  of  the  Layout  Composer  application  and  because  of  its  reusability 
saved  a  significant  amount  of  development  time.  The  following  will  describe  sev¬ 
eral  of  these  packages  and  point  out  some  key  concepts  and  components  of  core 
library. 

The  Building  Composer  core  library  requires  two  environment  variables  for 
proper  operation.  The  first  variable  is  “BuildingComposer.”  This  variable 
should  point  to  the  main  install  directory  for  Building  Composer.  This  directory 
is  where  Java  property  files  and  the  main  library  file  will  be  looked  for.  The  sec¬ 
ond  variable  is  “BuildingComposer_Project.”  This  variable  will  indicate  the  di¬ 
rectory  that  Building  Composer  will  create  and  search  for  projects. 


Common  Graphical  Components  and  Utilities 

Several  common  graphical  user  component  classes  were  created  that  can  be  used 
in  the  creation  of  display  panels.  These  common  components  are  for  text  fields, 
pull-down  fields,  list  fields,  label  fields,  and  horizontal  and  vertical  panels. 
These  components  can  be  used  within  the  JBuilder  designer  mode  when  creating 
JPanel  displays.  These  component  classes  are  in  package  BCGUI.GUIBeans. 

In  the  package  BCGUI. Utils,  there  are  several  classes  used  throughout  Criteria 
Composer.  Some  of  the  main  classes  of  importance  are  BaseLibrary  and 
MainLibrary;  ActivityLibrary,  RequirementSetLibrary,  PropertyLibrary,  and 
FunctionLibrary;  DataNode;  and  JDBCODBCAccess.  Some  of  these  are  de¬ 
scribed  below. 

Library  Classes 

There  are  several  classes  in  the  BCGUI.Utils  package  that  define  libraries  of  in¬ 
formation  that  are  searched  throughout  the  running  of  the  Building  Composer 
core  library.  These  classes  are  ActivityLibrary  (store  MDSActivity  objects),  Re- 
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quirementSetLibrary  (store  MDSRequirementSet  objects),  PropertyLibrary 
(store  MDSProperty  objects),  and  FunctionLibrary  (store  MDSFunction  objects). 
These  stores  of  information  are  populated  at  the  start  of  the  Building  Composer 
core  library  by  the  MainLibrary  class.  This  class  reads  a  table  row  from  an  ex¬ 
ternal  database  (or  datasource),  creates  an  object,  and  then  stores  it  in  a  library. 
These  libraries  are  then  searched  when  certain  actions  occur.  An  example  is 
when  a  new  building  object  is  created.  The  RequirementSetLibrary  would  be 
searched  to  see  if  any  requirements  should  be  added  to  this  new  building  object. 
Currently  a  Microsoft  Access  relational  database  is  used  as  the  external  data¬ 
base  (see  Appendix  E  for  a  listing  of  the  required  tables).  Here  is  the  code  that 
reads  and  creates  entries  for  the  ActivityLibrary: 

private  boolean  readActivityLibrary()  { 

II  read  activity  values 

try  { 

JDBCODBCAccess  dataSource  =  new  JDBCODBCAccess(m_dataSourceName,  "select  *  from  ActivityHeaders"); 

Vector  name  =  dataSource. populateVector(l); 

Vector  description  =  dataSource. populateVector(2); 
for  (int  i  =  0;  i  <  name.size();  ++i)  { 

String  activityName  =  (String)name.elementAt(i); 

MDSActivity  activity  =  m_activityLibrary.findActivity(activityName); 
if  (activity  ==  null)  { 

activity  =  new  MDSActivity(activityName); 

activity.setDescription((String)description.elementAt(i)); 

m_activityLibrary.addActivity(activity); 

} 

} 

} 

catch  (Exception  exc)  { 

BuildingComposer.errorMessage(exc); 
return  false; 

} 

return  true; 

} 


See  Appendix  F  for  further  information  on  the  creation  and  use  of  these  libraries. 


Data  Node  Class 


The  DataNode  class  defines  the  elements  of  data  maintained  within  a  project 
tree  (see  “Project  Tree”  p  45).  It  is  a  class  that  can  maintain  a  reference  to  a 
minimum  of  one  piece,  and  a  maximum  of  three  pieces,  of  data.  A  text  string  is 
attached  to  the  main  piece  of  data  and  returned  from  the  toString  method. 

public  class  DataNode  { 

Object  m_data; 

String  m_dataLabel; 

Object  m_userData1; 

Object  m_userData2; 

11========================================================================= 

/**  Creates  a  DataNode  object  with  the  given  data  object.  */ 
public  DataNode(Object  data,  String  dataLabel)  { 
m_data  =  data; 
m_dataLabel  =  dataLabel; 

} 

/**  Creates  a  DataNode  object  with  the  given  data  object  plus  one  additional  piece  of  data.  */ 
public  DataNode(Object  data,  String  dataLabel,  Object  userDatal)  { 
this(data,  dataLabel); 
m_userData1  =  userDatal; 


ERDC/CERL  TR-02-28 


45 


/**  Creates  a  DataNode  object  with  the  giver  data  object  plus  two  additional  pieces  of  data.  7 
public  DataNodejObject  data,  String  dataLabel,  Object  userDatal ,  Object  userData2)  { 
thisfdata,  dataLabel,  userDatal); 
m_userData2  =  userData2; 

} 

11=====================================================================-. 

public  Object  getDataQ  { 
return  m_data; 

} 

11=====================================================================-. 

public  void  setDataLabel(String  label)  { 
m_dataLabel  =  label; 

} 

public  String  getDataLabel()  { 
return  m_dataLabel; 

} 

11=====================================================================-. 

public  void  setUserDatal (Object  userDatal)  { 
m_userData1  =  userDatal; 

} 

public  Object  getUserDatal  ()  { 
return  m_userData1; 

} 

11=====================================================================-. 

public  void  setllserData2(0bject  userData2)  { 
m_userData2  =  userData2; 

} 

public  Object  getllserData2()  { 
return  m_userData2; 

} 

11=====================================================================-. 

public  String  toString()  { 
return  m_dataLabel; 

} 

} 


Project  Tree 

The  main  graphical  element  of  a  Building  Composer  application  is  the  project 
tree.  This  tree  displays  the  main  elements  within  a  project:  the  Project,  Site, 
Building,  Story,  Function  Instance,  and  Space  element.  The  project  tree  is  re¬ 
sponsible  for  the  display  of  these  main  project  elements  and  generation  of  mes¬ 
sages  when  certain  actions  are  performed  on  the  tree.  These  actions  are  a  key 
press,  a  mouse  button  clicked,  a  mouse  button  pressed,  a  mouse  button  released, 
and  a  tree  selection  value  change. 

The  base  class  for  a  project  tree  is  BaseProjectTree.  This  class  registers  listeners 
for  the  above-described  tree  actions  and  maintains  the  list  of  listeners  to  be  noti¬ 
fied  when  any  of  these  actions  occur.  The  following  are  the  methods  called  to 
register  listeners: 

public  synchronized  void  addProjectTreeListener(ProjectTreeListener  listener)  { 
public  synchronized  void  removeProjectTreeListener(ProjectTreeListener  listener)  { 


The  methods  that  a  listener  would  then  implement  to  receive  these  messages 
(see  ProjectTreeListener  interface)  are: 
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/* -  - 

*  ProjedTreeListener  methods 

+ - + - + - + - + - */ 

public  void  projectTree_keyTyped(KeyEvent  e)  { 
public  void  projectTree_mouseClicked(MouseEvent  e)  { 
public  void  projectTree_valueChanged(TreeSeledionEvent  e)  { 


The  main  class  for  a  project  tree  is  ProjectTree.  This  class  inherits  from  Base- 
ProjectTree  to  properly  display  the  main  project  elements  within  the  tree.  The 
following  breaks  down  the  code  of  the  ProjectTree  class: 


public  class  ProjectTree  extends  BaseProjectTree  { 

11========================================================================= 

public  ProjectTree()  { 
super(); 

try  { 

jblnit(); 

} 

catch  (Exception  e)  { 

BuildingComposer.errorMessage(e); 

} 

} 

private  void  jblnit()  throws  Exception  { 

II  setup  empty  tree  model 

setModel(new  DefaultTreeModel(createProjectBranch(null))); 

II  create  Tenderer 

DefauItTreeCellRenderer  Tenderer  =  new  DefauitTreeCellRendererQ; 

renderer.setClosedlcon(null); 

renderer.setLeaflcon(null); 

renderer.setOpenlcon(null); 

II  setup  tree 

setCellRenderer(renderer); 

getSelectionModel().setSelectionMode(TreeSelectionModel.SINGLE_TREE_SELECTION); 

} 


An  internal  method  to  get  the  “Code”  property  of  an  object,  often  used  in  the  dis¬ 
play  of  an  object  within  the  tree  is: 

11========================================================================= 

private  String  getLabel(MDSObject  obj)  { 

try  { 

String  id  =  obj.getStringPropertyf'Code"); 
if  (id  ==  null)  id  =  new  StringQ; 
return  id; 

} 

catch  (Exception  e)  { 

BuildingComposer.errorMessagef'ProjectTree:Exception  getting  label:  obj:  ”  +  obj); 
return  new  String(); 

} 

} 


Various  methods  can  create  node  labels: 

11=======================================================-. 

/**  Creates  a  project  node  label.  Needs  to  be  called  within  a  transaction.  */ 
public  String  projectLabel(MDSProject  project)  { 

return  new  Stringf'Project "  +  getLabel(project)); 

} 

public  String  siteLabel(MDSSite  site)  { 
public  String  buildingLabel(MDSBuilding  building)  { 
public  String  storyLabel(MDSBuildingStorey  story)  { 
public  String  functionLabel(MDSFunctionlnstance  function)  { 
public  String  spaceLabel(MDSSpace  space)  { 
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Various  methods  can  be  used  to  create  a  tree  node.  A  node  is  a  DefaultMutable- 
TreeNode  (see  JDK  documentation)  with  a  DataNode  object  as  a  piece  of  user 
data  (see  section  “DataNode  Class”  above): 

11========================================================================= 

/**  Creates  a  project  node.  The  DataNode  contains  a  MDSProject  object  as  data.  Needs  to  be  called  within  a  transaction.  7 
public  DefaultMutableTreeNode  projectNode(MDSProject  project)  { 

return  new  DefaultMutableTreeNode(new  DataNode(project,  DataNode. OBJECT,  projectLabel(project))); 

} 

public  DefaultMutableTreeNode  siteNode(MDSSite  site)  { 

public  DefaultMutableTreeNode  buildingNode(MDSBuilding  building)  { 

public  DefaultMutableTreeNode  storyNode(MDSBuildingStorey  story)  { 

public  DefaultMutableTreeNode  functionNode(MDSProgram  program,  MDSFunctionTemplate  template,  MDSFunctionlnstance  function)  { 
public  DefaultMutableTreeNode  spaceNode(MDSFunctionTemplate  template,  MDSFunctionlnstance  function,  MDSSpace  space)  { 


Various  methods  can  create  branches  within  a  tree: 

11========================================================================= 

/**  Need  to  check  for  null  return  value.  Needs  to  be  called  within  a  transaction.  7 
public  DefaultMutableTreeNode  createProjectBranch(MDSProject  project)  { 

DefaultMutableTreeNode  prjNode  =  new  DefaultMutableTreeNodejnew  DataNodefnull,  0,  "Project")); 
if  (project  ==  null)  return  prjNode; 

try  ( 

II  create  project  node 
prjNode  =  projectNode(project); 

II  site  node 

prjNode.add(createSiteBranch(project.getSite())); 

II  building  nodes 

Enumeration  buildings  =  project.getSite().getBuildings().elements(); 
while  (buildings.hasMoreElementsO)  { 

Clfcbuilding  bldgObj  =  (Clfcbuilding)buildings.nextElement(); 
prjNode.add(createBuildingBranch(bldgObj)); 

} 

} 

catch  (Exception  e)  { 

BuildingComposer.errorMessage("ProjectTree:Exception  building  project  branch!"); 
BuildingComposer.errorMessage(e); 

} 

return  prjNode; 

} 

public  DefaultMutableTreeNode  createSiteBranch(MDSSite  site)  { 

public  DefaultMutableTreeNode  createBuildingBranch(MDSBuilding  building)  { 

public  DefaultMutableTreeNode  createStoryBranch(MDSBuildingStorey  story)  { 

public  DefaultMutableTreeNode  createFunctionBranch(MDSProgram  program,  MDSFunctionlnstance  function)  { 
public  DefaultMutableTreeNode  createSpaceBranch(MDSFunctionlnstance  function,  MDSSpace  space)  { 


The  following  method  is  overridden  to  display  the  main  project  elements: 

11========================================================================= 

public  void  reset))  { 
super.reset(); 

if  (BuildingComposer.mainDatabaseServer.isDatabaseOpenQ)  { 

BuildingComposer.mainDatabaseServer.startReadOnlyTransaction(); 

setModel(new  DefaultTreeModel(createProjectBranch(BuildingComposer.prjCtl.getCurrentProject()))); 
BuildingComposer.mainDatabaseServer.commitTransactionQ; 

} 

else  { 

setModel(new  DefaultTreeModel(createProjectBranch(null))); 

} 

expandRow(O); 

setSelectionRow(1 );  II  causes  T reeSelectionEvent  -  select  site  object 
setSelectionRow(O);  II  causes  T reeSelectionEvent  -  select  project  object 
setShowsRootFlandles(true); 


} 


} 
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Figure  9.  Property  panel  classes. 


Property  Panels 

The  property  panel  classes  (Figure  9)  are  used  to  display  information  relevant  to 
an  object  that  is  not  displayed  within  a  requirement  grid  (see  section  “Require¬ 
ment  Grid”  below).  The  PropPanel  class  is  the  abstract  base  class  for  most  of  the 
other  classes:  ProjectPropPanel,  SitePropPanel,  BuildingPropPanel,  StoryProp- 
Panel,  FunctionPropPanel,  and  SpacePropPanel.  A  property  panel  is  typically 
made  up  of  common  graphical  components  described  above  (see  section  “Common 
Graphical  Components  and  Utilities”  above).  When  the  value  of  these  compo¬ 
nents  is  updated,  event  messages  are  generated  and  sent  to  registered  listeners. 


Here  are  some  code  highlights  of  PropPanel: 

public  abstract  class  PropPanel  extends  JPanel  { 

II  ========================================================================= 

II  Method  to  try  and  convert  the  text  value  of  the  given  FieldRow  into  a  double, 
protected  double  convertToDouble(FieldRow  row); 
11========================================================================= 

II  Method  to  update  the  given  propertyName  in  the  given  obj  with  the  text  value  from  the  given  row. 
protected  boolean  updateFromFieldRow(MDSObject  obj,  String  propertyName,  FieldRow  row); 
11========================================================================= 

II  Method  to  update  the  given  propertyName  in  the  given  obj  with  the  text  value  from  the  given  row. 
protected  boolean  updateFromComboBoxRow(MDSObject  obj,  String  propertyName,  ComboBoxRow  row); 
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The  following  methods  add  and  remove  listeners,  and  enable  the  event  messag¬ 
ing  from  the  property  panels: 

/**  Method  to  add  a  listener  for  property  panel  change  events.  */ 

public  synchronized  void  addPropertyPanelListener(PropertyPanelListener  listener); 

/**  Method  to  remove  a  listener  for  property  panel  change  events.  */ 

public  synchronized  void  removePropertyPanelListener(PropertyPanelListener  listener); 

II  Method  to  generate  a  property  panel  change  event. 

protected  void  notifyPropertyChanged(MDSObject  obj,  String  property,  Object  value); 


A  listener  would  then  implement  these  methods  to  receive  property  change  mes¬ 
sages  (see  PropertyPanelListener  interface): 

public  void  projectPropertyChange(MDSProject  project,  String  property,  Object  value); 
public  void  sitePropertyChange(MDSSite  site,  String  property,  Object  value); 
public  void  buildingPropertyChange(MDSBuilding  building,  String  property,  Object  value); 
public  void  storyPropertyChange(MDSBuildingStorey  story,  String  property,  Object  value); 
public  void  functionPropertyChange(MDSFunction  function,  String  property,  Object  value); 
public  void  spacePropertyChangejMDSSpace  space,  String  property,  Object  value); 


A  typical  property  panel  then  maintains  a  pointer  to  its  current  object  and  popu¬ 
lates  text  fields  with  appropriate  values.  A  typical  example  of  ProjectPropPanel 
is: 

public  class  ProjectPropPanel  extends  PropPanel  { 


The  current  object  is: 

MDSProject  curProject; 

ProjectTree  curTree  =  null; 

BorderLayout  borderLayoutl  =  new  BorderLayout(); 


The  panel  graphical  elements  are: 


VerticalPanel  jPanel2  =  new  VerticalPanelj); 

FieldRow  idRow  =  new  FieldRowf'ID:",  "ID  of  the  selected  Project''); 

FieldRow  codeRow  =  new  FieldRowf'Code:1',  8,  "Code  of  the  selected  Project."); 

FieldRow  titleRow  =  new  FieldRowf'Name:",  "Name  of  the  selected  Project."); 

HorizontalPanel  jPanel3  =  new  HorizontalPanel(); 

FieldRow  cityRow  =  new  FieldRowf'City:",  "City  in  which  the  selected  Project  is  located."); 
FieldRow  stateRow  =  new  FieldRowfState:",  2,  "State  in  which  the  selected  Project  is  located."); 
FieldRow  zipRow  =  new  FieldRowf'Zip:",  10,  "Zip  code  in  which  the  selected  Project  is  located."); 
HorizontalPanel  jPanel4  =  new  HorizontalPanel(); 

FieldRow  numberRow  =  new  FieldRowf'Number:",  8,  "Number  of  the  selected  Project."); 

FieldRow  fiscalRow  =  new  FieldRowf'Fiscal:",  12,  "Fiscal  Year  of  the  selected  Project.”); 

FieldRow  unitsRow  =  new  FieldRowf'Units:",  "Units  of  the  selected  Project."); 
11========================================================================. 

public  ProjectPropPanelQ  { 

try  { 

jblnitj); 

} 

catch  (Exception  ex)  { 

BuildingComposer.errorMessage(ex); 

} 

} 

11========================================================================. 

private  void  jblnit()  throws  Exception  { 


To  set  up  the  panels: 


this.setLayout(borderLayout1 ); 
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II  set  glues  and  strut  sizes 
codeRow.setAddEndGlue(true); 
codeRow.setStrutSize(25); 
titleRow.setStrutSize(21 ); 
cityRow.setStrutSize(35); 

DocumentFilter  stateDoc  =  new  DocumentFilter(2, " "); 

stateDoc.setUpperCaseOnly(true); 

stateRow.getTextField().setDocument(stateDoc); 

DocumentFilter  zipDoc  =  new  DocumentFilter(10, "  ,./<>?{}|[]\\\t+=-'!@#$%A&*()_;:'\""); 

zipDoc.setNoUpperCase(true); 

zipDoc.setNoLowerCase(true); 

zipRow.getTextField().setDocument(zipDoc); 

jPanel2.setTitleString("Project  Properties"); 

jPanel2.setBorderType(2); 

if  (BuildingComposer.developerVersion)  jPanel2.add(idRow); 

idRow.setEnabled(false); 

jPanel2.add(codeRow); 

jPanel2.add(titleRow); 

jPanel3.add(cityRow); 

jPanel3.add(stateRow); 

jPanel3.add(zipRow); 

jPanel2.add(jPanel3); 

jPanel4.add(numberRow); 

jPanel4.add(fiscalRow); 

jPanel4.add(unitsRow); 

unitsRow.setEnabled(false); 

jPane!2.add(jPanel4); 


Add  focus  and  action  listeners  for  each  editable  field.  These  listeners  will  start 
the  event  message  generation  and  sending: 

codeRow.getTextField().addFocusListener(newjava.awt.event.FocusAdapter()  { 
public  void  focusLost(FocusEvent  e)  { 

if  (updateFromFieldRowf'Code",  codeRow))  { 
updateTreeNodeLabel(); 

} 

} 

}); 

codeRow.getTextField().addActionListener(new  ActionListener()  { 
public  void  actionPerformed(ActionEvent  e)  { 

if  (updateFromFieldRowf'Code",  codeRow))  { 
updateTreeNodeLabel(); 

} 

} 

}); 

titleRow.getTextField().addFocusListener(newjava.awt.event.FocusAdapter()  { 
public  void  focusLost(FocusEvent  e)  { 

updateFromFieldRowf'Name",  titleRow); 

} 

}); 

titleRow.getTextField().addActionListener(new  ActionListener()  { 
public  void  actionPerformed(ActionEvent  e)  { 
updateFromFieldRowf'Name",  titleRow); 

} 

}); 

cityRow.getTextField().addFocusListener(newjava.awt.event.FocusAdapter()  { 
public  void  focusLost(FocusEvent  e)  { 

updateFrom Field RowfCity” ,  cityRow) ; 

} 

}); 

cityRow.getTextField().addActionListener(new  ActionListener()  { 
public  void  actionPerformed(ActionEvent  e)  { 
updateFrom  Field  RowfCity" ,  cityRow) ; 

} 

}); 

stateRow.getTextField().addFocusListener(newjava.awt.event.FocusAdapter()  { 
public  void  focusLost(FocusEvent  e)  { 

updateFromFieldRowf'State",  stateRow); 

} 

}); 

stateRow.getTextField().addActionListener(new  ActionListener()  { 
public  void  actionPerformed(ActionEvent  e)  { 
updateFromFieldRowf'State",  stateRow); 

} 
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}); 

zipRow.getTextField().addFocusListener(newjava.awt.event.FocusAdapter()  { 
public  void  focusLost(FocusEvent  e)  { 

updateFromFieldRowf'Zip",  zipRow); 

} 

}); 

zipRow.getTextField().addActionListener(new  ActionListener()  { 
public  void  actionPerformed(ActionEvent  e)  { 
updateFromFieldRowf’Zip",  zipRow); 

} 

}); 

numberRow.getTextField().addFocusListener(newjava.awt.event.FocusAdapter()  { 
public  void  focusLost(FocusEvent  e)  { 

updateFromFieldRowf’Number",  numberRow); 

} 

}); 

numberRow.getTextField().addActionListener(new  ActionListener()  { 
public  void  actionPerformed(ActionEvent  e)  { 

updateFromFieldRowf’Number",  numberRow); 

} 

}); 

fiscalRow.getTextField().addFocusListener(newjava.awt.event.FocusAdapter()  { 
public  void  focusLost(FocusEvent  e)  { 

updateFromFieldRowf’FY",  fiscalRow); 

} 

}); 

fiscalRow.getTextField().addActionListener(new  ActionListener()  { 
public  void  actionPerformed(ActionEvent  e)  { 
updateFromFieldRowf’FY",  fiscalRow); 

} 

}); 

this.add(jPane!2,  BorderLayout.CENTER); 


An  update  of  certain  fields  may  require  a  display  update  of  the  main  project  tree: 

a ========================================================================= 

private  void  updateTreeNodeLabel()  { 
if  (curTree  !=  null)  { 

DefaultMutableTreeNode  treeNode  =  curTree.getSelectedNode(); 

DataNode  dataNode  =  (DataNode)treeNode.getUserObject(); 

BuildingComposer.mainDatabaseServer.startReadOnlyTransaction(); 

dataNode.setDataLabel(curTree.projectLabel(curProject)); 

BuildingComposer.mainDatabaseServer.commitTransaction(); 

curTree.updateSelectedNode(dataNode); 

} 

} 


The  following  is  called  to  set  the  main  project  tree  (may  need  a  display  update): 

11========================================================================= 

public  void  setProjectTree(Object  tree)  { 
if  (tree  instanceof  ProjectTree)  { 
curTree  =  (ProjectT  reejtree; 

} 

else  { 

curTree  =  null; 

} 

} 


The  following  is  then  called  to  set  the  current  object  and  fill  the  field  values: 

11========================================================================= 

/**  Needs  to  be  called  within  a  read-only  transaction!  */ 
public  void  fillPanel(MDSProject  project)  { 
if  (project  ==  null)  return; 
curProject  =  project; 

idRow.getTextField().setText(curProject.getGUIDQ); 

codeRow.getTextField().setText(curProject.getStringProperty("Code")); 

titleRow.getTextField().setText(curProject.getStringProperty("Name")); 

cityRow.getTextField().setText(curProject.getStringProperty("City")); 
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stateRow.getTextField().setText(curProject.getStringProperty("State")); 

zipRow.getTextField().setText(cu  rProject.getStringProperty("Zip")); 

numberRow.getTextField().setText(curProject.getStringProperty("Number”)); 

fiscalRow.getTextField().setText(curProject.getStringProperty("FY")); 

if  (BuildingComposer.englishUnits  ==  true)  unitsRow.getTextField().setText("English"); 

else  unitsRow.getTextField().setText("Metric"); 

this.revalidate(); 

this.repaint(); 


This  is  overridden  to  pass  the  current  object: 

11========================================================= 

private  boolean  updateFromFieldRow(String  propertyName,  FieldRow  row)  { 
return  super.updateFromFieldRow(curProject,  propertyName,  row); 

} 


Requirements 

A  requirement  (or  property)  in  Building  Composer  is  implemented  using  the 
MDSRequirement  class  from  the  object  model.  Several  attributes  defined  in  the 
MDSRequirement  class  are  used  during  the  Building  Composer  application  and 
are  worth  mentioning. 

A  requirement  in  Building  Composer  has  a  level  attribute  attached  to  it.  This 
integer  attribute  indicates  which  object  in  the  hierarchy  should  have  this  re¬ 
quirement  added  to  it.  The  possible  values  for  the  level  attribute  are:  1  =  project, 
2  =  site,  4  =  building,  8  =  story,  16  =  function,  32  =  space.  These  values  can  be 
added  to  have  a  requirement  added  at  multiple  levels,  i.e.,  level  =  48  equates  to 
function  and  space.  As  objects  are  created  in  Building  Composer,  requirements 
are  searched  and  added  as  indicated  by  the  level  attribute. 

A  requirement  also  has  an  attached  isRequired  attribute.  This  Boolean  attribute 
indicates  weather  a  requirement  should  be  automatically  added  to  an  object 
when  it  is  created,  e.g.,  if  a  requirement  is  level  4  and  isRequired  is  false,  then 
when  a  new  building  object  is  created,  this  requirement  would  not  be  added. 


Requirement  Grid 

The  requirement  grid  is  used  to  display  the  requirement  sets  and  requirements 
for  the  currently  selected  object  in  the  project  tree.  Figure  10  shows  a  grid  of 
cells  representing  a  series  of  requirement  sets  and  their  requirements  on  a  spe¬ 
cific  tab.  In  this  example  the  tab  name  is  “Architecture,”  one  requirement  set 
name  is  “1:  Size  -  Horizontal,”  and  one  requirement  name  is  “Length  Desired.” 
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Design  Criteria 

Program]  Properties  Architecture  |  Electrical |  HVAC|  Lighting |  Plumbing  |  Communication!  Security 

Architecture  Criteria - 


Requirement 

Value 

UOM 

Source 

Comment 

1 :  Size  -  Horizontal  | 

Aspect  Ratio  Desire 

Ratio  (length/width) 

Design  Guide 

Length  Desired 

Feet 

Design  Guide 

Width  Desired 

Feet 

Design  Guide 

2:  Size  -  Vertical 

Ceiling  Height  De^, 

Feet 

Design  Guide 

Floor  Thickness  Dt 

Feet 

Design  Guide 

3:  Miscellaneous 

Solution  for  Archite*. 

String 

System 

Solution  for  Furnittv 

String 

System 

Solution  for  Lighting 

String 

System 

Solution  for  Mechat. 

String 

System 

Solution  for  Plumbt 

String 

System 

Qnli  itinn  finr  Pnu/or  1 

Qtri  n  n 

Qvctom 

Add  User  Criteria... 

Add  Library  Criteria... 

d 


Figure  10.  Requirement  set. 


The  first  class  used  with  the  requirement  grid  is  the  RequirmentGridDataSource 
class.  This  class  defines  the  model  of  how  the  data  displayed  is  stored.  Separat¬ 
ing  the  data  model  in  this  way  allows  for  the  possibility  of  different  actual  dis¬ 
plays  of  the  data.  This  separation  follows  the  model-view-controller  design  pat¬ 
tern.  The  RequirementGridDataSource  class  uses  a  Vector  of  Vector  objects  to 
cache  the  data  within  the  grid.  Data  from  requirement  sets  and  requirements, 
which  require  database  access  and  are  therefore  slower,  are  stored  in  this  data 
cache  making  future  retrievals  faster. 

public  abstract  class  RequirementGridDataSource  implements  lnt_PropertyGrid,  PropertyChangeListener  { 

II  elements  of  data  in  m_data  are  ListNode  objects  with  either  an 

II  MDSRequirementSet  object  or  MDSProperty  object  (with  their  MDSRequirementSet  as  user  data) 
private  Vector  m_data  =  new  Vector)); 

II  data  cache  for  quick  access 

private  VectorDataCache  m_dataCache  =  new  VectorDataCache(); 
public  void  addRequirementSet(MDSRequirementSet  reqSet)  { 

m_data.addElement(new  ListDataNode(reqSet,  reqSet.getName())); 

Enumeration  reqs  =  reqSet.getRequirements().elements(); 
while  (reqs.hasMoreElements())  { 

MDSProperty  property  =  (MDSProperty)reqs.nextElement(); 
m_data.addElement(new  ListDataNode(property,  property.getName(),  reqSet)); 

} 

sortData(); 

resetCacheQ; 

} 
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Method  to  get  the  data  item  for  a  specific  cell  (note  the  check  of  the  data  cache  at 
the  beginning  and  populate  of  the  data  cache  at  the  end ): 


public  Object  getT ableDataltem(int  row,  int  col)  { 
if  (row  <  0)  return  null; 

II  use  m_dataCache  item  if  present 
Object  result  =  m_dataCache.getltem(row,  col); 
if  (result  !=  null) 
return  result; 

Object  obj  =  getDataElement(row); 

II  data,  is  it  a  MDSRequirementSet  object? 
if  (obj  instanceof  MDSRequirementSet)  { 

BuildingComposer.mainDatabaseServer.startReadOnlyTransaction(); 
MDSRequirementSet  reqSet  =  (MDSRequirementSet)obj; 
if  (col  ==  levelCol())  result  =  new  Integer(-I); 
else  if  (col  ==  requirementColO)  { 
result  =  reqSet.getName(); 

} 

else  if  (col  ==  requiredCol())  result  =  new  Boolean(true); 
else  if  (col  ==  changeCol())  result  =  new  Boolean(false); 
else  if  (col  ==  thirdPartyCol())  result  =  reqSet.getLibraryNameQ; 
else  if  (col  ==  descriptionCoi())  result  =  reqSet.getDescriptionQ; 
else  if  (col  ==  guidCol())  result  =  reqSet.getGUIDQ; 
else  result  =  new  String(); 

BuildingComposer.mainDatabaseServer.commitTransactionQ; 

} 

II  data,  is  it  a  MDSProperty  object? 
else  if  (obj  instanceof  MDSProperty)  { 

BuildingComposer.mainDatabaseServer.startReadOnlyTransaction(); 

MDSProperty  property  =  (MDSProperty)obj; 

if  (col  ==  levelColj))  result  =  new  Integer(property.getLevelQ); 

else  if  (col  ==  requirementColO) result  =  new  Stringf  "  +  property.getDisplayName()); 

else  if  (col  ==  requiredCol())  result  =  new  Boolean(property.getlsRequired()); 

else  if  (col  ==  changeColQ)  result  =  new  Boolean(property.getValueCanBeChangedQ); 

else  if  (col  ==  valueCol())  { 

String  data  =  property.getValue(); 

if  (data.equalsIgnoreCaseftrue")  ||  data.equalsignoreCasef'false"))  { 
result  =  new  Boolean(data); 

} 

else  { 

result  =  data; 

} 

} 

else  if  (col  ==  uomCol())  result  =  property.getllnitOfMeasure(); 
else  if  (col  ==  sourceCol())  result  =  property.getSource(); 
else  if  (col  ==  commentColQ)  result  =  property.getComment(); 
else  if  (col  ==  thirdPartyCol())  result  =  property.getLibraryName(); 
else  if  (col  ==  descriptionCol())  result  =  property.getDescription(); 
else  if  (col  ==  guidCol())  result  =  property.getGUID(); 
else  if  (col  ==  nameColO)  result  =  property.getName(); 
BuildingComposer.mainDatabaseServer.commitTransaction(); 

} 

II  default 

else  if  (col  ==  requirementColO  II co1  ==  valueCol()) 
result  =  obj; 

II  add  item  to  m_dataCache 
m_dataCache.addltem(result,  row,  col); 
return  result; 


The  RequirementGridDataSource  class  also  has  methods  to  determine  if  a  grid 
cell  is  editable  and  resizable: 

public  boolean  isEditable(int  row,  int  col)  { 
public  boolean  isResizeable(int  col)  { 


Requirement  values  may  require  a  special  editor  to  be  used  to  update  of  their 
values.  This  typically  occurs  when  the  requirement  is  defined  from  an  extension 
(see  “Extensions,”  p  56)  that  has  special  validation  rules  to  be  checked  or  value 
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that  cannot  adequately  be  typed  in  by  the  user.  To  accommodate  this  special 
editor,  two  methods  are  defined: 


public  boolean  useSpecialEditor(int  row)  { 
public  void  specialEdit(int  row)  { 


These  methods  would  then  be  called  from  within  the  table  that  displays  the  grid 
before  an  actual  cell  edit  takes  place.  For  example  (here  m_model  is  an  instance 
of  the  RequirementGridDataSource  class): 


II  stop  editing  before  it  happens 
public  boolean  editCellAt(int  row,  int  column,  EventObject  e){ 
II  does  this  cell  require  a  special  editor? 
if  (column  ==  m_model.valueCol())  { 

if  (m_model.useSpecialEditor(row))  { 
m_model.specialEdit(row); 
return  false; 

} 

} 

//else... 

return  super.editCellAt(row,  column,  e); 


The  requirement  grid  was  implemented  using  both  the  Java  Swing  JTable  class 
and  the  JClass  JCTable  class.  This  was  done  because  of  the  limitation  of  the  Mi- 
croStation  JVM,  which  was  based  on  Sun  JVM  1.1.  The  JClass  JCTable  class  is 
based  on  Sun  JVM  1.2. 


Implementing  the  requirement  grid  using  the  Java  Swing  JTable  class  is  done 
with  the  RequirementGrid,  RequirementGridTable  (which  extends  JTable), 
ReqGridDataSource  (which  extends  RequirementGridDataSource),  and  UserT- 
ableModel  (which  extends  ReqGridDataSource)  classes. 

class  RequirementGrid  implements  lnt_RequirementGrid  { 

ReqGridDataSource  m_dataSource; 

RequirementGridTable  m_dataTable; 
class  RequirementGridTable  extends  JTable  { 

Implementing  the  requirement  grid  using  the  JClass  JCTable  class  is  done  with 
the  RequirementGrid_CC,  RequirementGridTable_CC  (extends  JCTable), 
ReqGridDataSource_CC  (extends  RequirementGridDataSource),  and  UserT- 
ableModel_CC  (extends  ReqGridDataSource_CC)  classes. 

class  RequirementGrid_CC  implements  lnt_RequirementG rid  { 

ReqGridDataSource_CC  m_dataSource; 

RequirementGridT  able_CC  m_dataT  able; 
class  RequirementGridTable_CC  extends  JCTable  { 

Classes  RequirementGrid  and  RequirementGrid_CC  implement  interface 
Int_RequirementGrid.  This  is  done  so  that  an  instance  of  either  can  be  created 
and  then  used  in  the  same  manner.  This  code  from  the  TabPanel  class  shows 
how  to  create  a  requirement  grid  based  on  the  Java  Version: 
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II  create  requirement  grid 
lnt_RequirementGrid  requirementGrid  =  null; 

try  { 

if  (<Java  Version  <  1.2>)  { //  earlier  than  1 .2  Java  Version 

Class  reqCI  =  Class.forNamefBCGUI. Panel. DesignCriteria. RequirementGrid"); 
requirementGrid  =  (lnt_RequirementGrid)reqCl.newlnstance(); 

} 

else  { Java  Version  1 .2  or  later 

Class  reqCI  =  Class.forNamefBCGUI. Panel. DesignCriteria. RequirementGrid_CC"); 
requirementGrid  =  (lnt_RequirementGrid)reqCl.newlnstance(); 

} 

} 

catch  (Exception  ex)  { 

} 


The  Int_RequirementGrid  interface  is: 

public  interface  lnt_RequirementGrid  { 

/**  Sets  whether  this  grid  can  be  edited.  The  grid  will  be  empty  after  this  call!  7 
public  void  setEditable(boolean  editable); 

/**  Sets  whether  this  grid  can  be  selectable.  7 
public  void  setSelectable(boolean  selectable); 

/**  Returns  the  JComponent  to  display  the  grid.  7 
public  JComponent  getDataTable(); 

/**  Removes  all  MDSRequirementSets  (and  their  MDSProperty  objects)  from  the  grid.  7 
public  void  cleanup)); 

/**  Adds  a  MDSRequirementSet  (and  it's  MDSProperty  objects)  to  the  grid.  7 
public  void  addRequirementSet(MDSRequirementSet  reqSet); 

/**  Returns  the  number  of  rows  in  the  grid.  7 
public  int  getNumberOfRows(); 

/**  Gets  the  currently  selected  MDSProperty  objects  from  the  grid.  7 
public  Vector  getSelectedQ; 

} 


Extensions 


Though  the  Building  Composer  core  library  has  a  default  set  of  requirements 
that  are  associated  with  an  element,  it  is  not  possible  that  all  requirements  can 
be  defined.  In  addition,  a  future  custom  application  from  a  third  party  may  need 
requirements  of  their  own  added  to  perform  some  type  of  action  or  analysis.  An 
extension  is  the  term  for  one  of  these  custom  applications.  An  extension  pro¬ 
vides  new  capabilities  and  usually  requirements  to  a  project.  The  Layout  Com¬ 
poser  application  is  an  example  of  an  extension.  To  become  an  extension  and  in¬ 
teract  with  the  Building  Composer  core  library,  an  extension  add-on  must 
implement  an  interface  that  provides  a  common  entry  point  for  the  Building 
Composer  core  library.  This  interface  is  the  Extensionlnterface: 

II  Interface  that  all  third  party  classes  must  implement, 
public  interface  Extensionlnterface  { 

/**  Called  to  get  extension  name.  7 
public  String  getName(); 

/**  Called  to  get  extension  datasource  name.  7 
public  String  getDataSource(); 

/**  Called  to  get  extension  icon  or  null  if  none.  7 
public  Icon  getlcon(); 

r  Return  true  if  special  editor  is  to  be  used  for  given  MDSProperty.  7 
public  boolean  isSpecialEditorRequired(MDSProperty  property); 

/**  Called  to  allow  extension  to  edit  given  MDSProperty.  7 

public  void  editRequirement(Frame  frame,  MDSAppinst  obj,  MDSRequirementSet  requirementSet,  MDSProperty  property); 

/**  Called  to  allow  extension  to  validate  new  value  for  given  MDSProperty.  7 

public  boolean  validateValue(MDSApplnst  obj,  MDSRequirementSet  requirementSet,  MDSProperty  property,  String  newValue); 
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/**  Return  JPanel  to  display  for  given  MDSRequirementSet.  Return  null  if  none.  7 

public  JPanel  getCustomPanel(lnt_MDSRequirementSetContainerobj,  MDSRequirementSet  requirementSet); 

/**  Called  to  allow  extension  to  set  background/foreground  colors  and  font  of  a  property  cell.  7 

public  void  setPropertyCellStyle(lnt_PropertyGrid  grid,  MDSAppInst  obj,  MDSRequirementSet  requirementSet,  MDSProperty  property); 

} 


An  extension  can  be  loaded  manually  by  the  user  or  automatically  at  creation  of 
a  new  project.  To  have  the  extension  automatically  loaded,  an  entry  needs  to  be 
made  in  the  BCExtensions. properties  file.  This  entry  indicates  the  name  of  a 
component  file  and  the  location  of  that  component  file.  Here  is  a  sample  proper¬ 
ties  file  entry  would  be: 

LayoutComposer.cmp=d:\\code\\java\\layoutcomposer\\layoutcomposer.cmp 


The  component  file  will  then  have  an  entry  that  will  indicate  the  archive  file  to 
search  and  the  name  of  the  class  that  implements  the  Extensionlnterface  inter¬ 
face.  Here  is  a  sample  component  file: 

LayoutComposer.zip;LayoutComposer.LayoutComposerExt 

The  Building  Composer  core  library  can  use  this  information  to  try  to  load  the 
extension.  Once  loaded,  the  extension  database  of  default  requirements  is 
searched  and  requirements  are  added  to  appropriate  elements  within  the  current 
project.  Future  elements  created  will  have  requirements  from  the  extension  da¬ 
tabase  automatically  added. 


Common  Commands 


Several  developed  commands  can  be  used  within  a  final  application.  The  com¬ 
mands  developed  in  the  Building  Composer  core  library  implement  the  command 
design  pattern.  This  design  pattern  allows  for  easy  implementation  of  an  undo 
and  redo  capability  within  an  application.  Within  the  Building  Composer  core 
library,  there  are  primary  and  sub  commands.  A  sub  command  does  the  main 
piece  of  work  done  within  a  command.  Here  is  the  interface  that  a  sub  command 
implements: 

x/**  Command  interface  based  on  Command  pattern.  7 
public  interface  Command  { 

/** 

*  Perform  the  command  encapsulated  by  this  object. 

*  @return  <code>true<code>  if  sucessful  and  can  be  undone. 

*<p> 

*  To  create  single-shot  commands,  maintain  boolean  member  variable  and 

*  return  false  if  the  object's  dolt  command  was  previously  called.  This 

*  variable  would  be  reset  upon  a  sucessful  undolt  call. 

7 

public  abstract  boolean  doltQ; 

/** 

*  Undo  the  last  invocation  of  dolt. 

*  @return  <code>true<code>  if  the  undo  was  successful. 

7 

public  abstract  boolean  undoltQ; 
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} 


Here  is  an  example  of  a  sub  command: 

public  class  Sub_AddBuilding  implements  Command  { 
private  boolean  m_Done  =  false; 
private  Clfcsite  m_curSite; 
private  Clfcbuilding  m_curBuilding; 
private  String  m_prjGUID; 
private  String  m_bldgGUID; 

II  ======================================================================= 

public  Sub_AddBuilding(Clfcsite  site)  { 

BuildingComposer.mainDatabaseServer.startReadOnlyTransaction(); 
m_prjGUID  =  BuildingComposer.prjCtl.getCurrentProject().getGUID(); 
BuildingComposer.mainDatabaseServer.commitTransaction(); 
m_curSite  =  site; 

} 

II  ======================================================================= 

public  boolean  dolt()  { 

II  if  this  command  has  already  been  done  then  don't  dolt  again 
if  (m_Done)  { 
return  false; 

} 

try  { 

BuildingComposer.mainDatabaseServer.startUpdateTransaction(); 
if  (m_curBuilding  ==  null)  { II  first  time  running 

II  create  new  building,  set  current  building,  get/set  guid,  and  add  properties 

BuildingComposer.prjCtl.addBuildingO; 

m_curBuilding  =  BuildingComposer.prjCtl.getCurrentBuilding(); 

m_bldgGUID  =  m_curBuilding.getGUID(); 

ExtensionUtilities  extUtils  =  new  ExtensionUtilities(); 
extUtils.addProperties(m_curBuilding);  II  add  required  properties 

} 

else  { 

II  readd  previously  created  building 
II  add  link 

m_curSite.linkContainee(m_curBuilding); 

} 

BuildingComposer.mainDatabaseServer.commitTransactionQ; 

II  sucess 
m_Done  =  true; 
return  true; 

} 

catch  (Exception  e)  { 

BuildingComposer.errorMessage(e); 

BuildingComposer.mainDatabaseServer.abortTransactionQ; 

} 

II  error 
return  false; 

}  II  dolt 

II  ======================================================================= 

public  boolean  undolt()  { 

II  if  this  command  has  not  already  been  done  then  don't  undolt 
if  (!m_Done)  { 
return  false ; 

} 

try  { 

BuildingComposer.mainDatabaseServer.startUpdateTransaction(); 

II  remove  link 

m_curSite.unlinkContainee(m_curBuilding); 

BuildingComposer.mainDatabaseServer.commitTransactionQ; 

II  sucess 
m_Done  =  false; 
return  true; 

} 

catch  (Exception  e)  { 

BuildingComposer.errorMessage(e); 

BuildingComposer.mainDatabaseServer.abortTransaction(); 

} 

II  error 
return  false; 

}// undolt 

II  ======================================================================= 

public  Clfcbuilding  getBuilding()  { 
return  m_curBuilding; 
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} 

} 


A  primary  command  can  call  one  or  more  sub  commands.  Here  is  the  interface 
that  a  primary  command  implements: 

/**  PrimaryCommand  interface  based  on  Command  pattern.  */ 
public  interface  PrimaryCommand  extends  Command  { 

/** 

*  Manages  undo  and  redo  functionality  of  commands. 

*  Could  be  enhanced  to  include  sequencing,  logging,  and  scheduling  functionality. 

*/ 

public  final  static  CommandManager  commandManager  =  new  CommandManagerQ; 

/** 

*  PrimaryCommands  should  use  this  method  to  define  the  name  of  the 

*  command  followed  by  the  name  of  the  object  it  is  performing  on  for 

*  the  purposes  of  the  undo/redo  GUI  string. 

*/ 

public  abstract  String  toString(); 

} 


Here  is  an  example  of  a  primary  command: 

public  class  Cmd_AddBuilding  implements  PrimaryCommand  { 
private  Sub_AddBuilding  mSub_addBuilding  =  null; 
private  String  mjabel; 


public  Cmd_AddBuilding(Clfcsite  site)  { 

II  construct  subcommand 

mSub_addBuilding  =  new  Sub_AddBuilding(site); 

mjabel  =  new  Stringf'Add  Building"); 

II  register  with  CommandManager 

try  { 

commandManager.invokeCommand(this); 

} 

catch  (CommandException  e)  { 

BuildingComposer.errorMessage(e); 

} 

} 

II ========================================================================= 

/**  Method  called  by  CommandManager  to  do  and  redo  the  command.  Should  not  be  called  directly.*/ 
public  boolean  dolt()  { 

return  mSub_addBuilding.dolt(); 

}  II  dolt 

11========================================================================= 

/**  Method  called  by  CommandManager  for  undo.  Should  not  be  called  directly.*/ 
public  boolean  undoltf)  { 

return  mSub_addBuilding.undolt(); 

}// undolt 

11========================================================================= 

public  String  toString()  { 
return  mjabel; 

} 

} 


In  the  Building  Composer  core  library,  the  CommandManager  class  maintains 
the  undo/redo  lists  and  calling  the  dolt  method  for  a  primary  command.  When 
constructed  a  primary  command  notifies  the  static  CommandManager  instance 
of  its  creation.  The  CommandManager  then  calls  the  dolt  method  of  the  primary 
command.  Here  is  some  code  from  the  CommandManager  class: 

public  class  CommandManager  { 

11========================================================================= 

/** 

*  Invoke  a  command  and  add  it  to  the  history,  The  command  will  be  added 

*  to  the  command  history  if  dolt  returns  true. 
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11============================================================ 

public  void  invokeCommand(Command  command)  throws  CommandException  { 


II  call  the  commands  dolt  method 

try  { 

if  (command.dolt())  { 

addToDoneList(command); 

} 

} 

catch  (Exception  e)  { 

//intercept  all  exceptions  so  that  we  can  end  command  nicely 
BuildingComposer.errorMessage(e); 

} 

}  II  invokeCommand 

II  ================================================================== 

/** 

*  Undo  the  most  recent  command  in  the  commmand  history. 

*/ 

11================================================================== 

protected  void  undoQ  { 

if  (m_doneList.isEmpty()  ==  false)  {  II  If  there  are  commands  in  the  m_doneList 
Command  undoCommand; 

II  get  and  remove  first  element  in  the  m_doneList 
undoCommand  =  (Command)m_doneList.firstElement(); 
m_doneList.removeElementAt(0); 

II  call  the  commands  undolt  method 

try  { 

undoCommand.  undolt(); 

} 

catch  (Exception  e)  { 

//intercept  all  exceptions  so  that  we  can  end  command  nicely 
BuildingComposer.errorMessage(e); 

} 

II  add  command  that  was  just  undone  into  redo  list 
m_redoList.insertElementAt(undoCommand,0); 

} 

}  //  undo 

11================================================================== 

/** 

*  Redo  the  most  recently  undone  command. 

*/ 

11================================================================== 

protected  void  redoQ  { 

if  (m_redoList.isEmpty()  ==  false)  { II  If  the  redo  list  is  not  empty 
Command  redoCommand; 

II  get  and  remove  first  element  in  m_doneList  list 
redoCommand  =  (Command)m_redoList.firstElement(); 
m_redoList.removeElementAt(0); 

II  call  the  commands  dolt  method 
try  { 

redoCommand.dolt(); 

} 

catch  (Exception  e)  { 

//intercept  all  exceptions  so  that  we  can  end  command  nicely 
BuildingComposer.errorMessage(e); 

} 

II  add  command  that  was  just  undone  into  m_doneList 
m_doneList.insertElementAt(redoCommand,0); 

} 

}  II  redo 

} 


With  the  separation  of  commands  into  primary  and  sub,  an  extension  application 
can  develop  their  own  commands  that  implement  the  PrimaryCommand  inter¬ 
face  that  will  automatically  follow  the  command  design  pattern.  These  custom 
commands  may  also  use  the  sub  commands  that  have  been  developed  within  the 
Building  Composer  core  library. 
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5  Criteria  Composer  Application 


The  Criteria  Composer  application  builds  on  top  of  the  Building  Composer  core 
library  to  provide  a  complete  graphical  user  interface  to  input,  display,  and  ma¬ 
nipulate  data  within  the  database.  The  main  class  for  the  Criteria  Composer 
application  is  Framel.  This  class  creates  a  JFrame  that  contains  an  instance  of 
the  ProjectCompositionPanel  and  DesignCriteriaPanel  class.  This  class  also  im¬ 
plements  the  Int_MainFrame  interface.  This  is  the  interface  that  the  Building 
Composer  core  library  uses  to  interact  with  the  main  frame  (or  application).  The 
Building  Composer  core  library  will  “ask”  the  main  frame  at  specific  times  for 
information  or  to  inquire  about  appropriate  action.  Here  is  the  Int_MainFrame 
interface: 


public  interface  lnt_MainFrame  { 

/**  Routine  to  return  JFrame.  7 
public  JFrame  getJFrameQ; 

/**  Routine  to  return  ProjectT reeUtils  object  to  modify  tree.  7 
public  ProjectT reeUtils  getTreeUtils(); 

/**  Called  after  the  database  has  been  opened.  Parameter  'title'  should  be  added  to  frame  title. 

The  database  will  be  open!  7 
public  void  createOrOpenDB(String  title); 

/**  Called  before  the  database  is  closed.  Write  out  any  database  level  information. 

The  database  will  be  open!  7 
public  void  preCloseDBQ; 

/**  Called  after  the  database  is  closed. 

The  database  will  NOT  be  open!  7 
public  void  postCloseDBQ; 

/**  Called  when  File->Exit  is  selected.  This  routine  gives  the  application  an  opportunity  to  disallow  the  shutdown. 
The  database  will  be  open!  7 
public  boolean  shutDownOKj); 

r  Called  when  File->Exit  is  selected.  Write  out  any  session  level  information. 

Upon  return  BuildingComposer  will  call  System.exit! 

The  database  will  NOT  be  open!  7 
public  void  shutDownQ; 
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6  Future  Work 


Though  a  good  and  fairly  robust  object  model,  several  items  of  concern  or  places 
for  improvement  should  be  mentioned.  Some  these  items  (listed  in  no  particular 
order)  are: 

1.  The  database  does  no  “garbage  collection.  ”  Though  items  are  added  to  the  data¬ 
base  automatically  through  transitive  persistence  whenever  a  transaction  is 
closed,  there  is  no  automatic  deletion,  or  removal,  of  an  object.  Once  added  to  the 
database,  an  object  will  remain  in  it  until  specifically  removed,  even  though  no 
other  object  in  the  database  may  reference  it  (or  if  may  no  longer  be  used).  Meth¬ 
ods  with  the  ObjectStore  PSE  database  do  allow  for  searching  and  removal  of 
non-referenced  objects  within  a  database.  However,  in  some  cases,  a  disused  ob¬ 
ject  may  still  be  of  some  use.  The  best  approach  to  solve  this  may  be  the  imple¬ 
mentation  of  a  “delete”  method  within  all  classes  in  the  object  model.  This 
method  would  then  be  responsible  for  removing  itself  and  variables  from  the  da¬ 
tabase.  One  item  of  note  here  is  that  in  the  current  implementation  of  the  object 
model,  the  classes  do  not  know  of  the  database  itself.  The  fundamental  question 
is  “Should  an  object  know  about  how  it  is  stored?”  and  “What  if  that  storage  ap¬ 
proach  changes?” 

2.  Event  messages  generated  from  within  the  object  model.  There  are  several 
places  within  the  Building  Composer  core  library  where  listeners  can  be 
added/removed  to  receive  event  messages  when  an  object  is  manipulated.  A  bet¬ 
ter  approach  may  be  to  have  the  object  model  elements  themselves  actually  gen¬ 
erate  the  event  messages.  This  way  the  elements  can  send  event  messages 
whenever  an  element  is  created,  manipulated,  or  deleted. 

3.  The  current  object  model  is  based  on  the  IFC  1.5  version.  Changes  to  the  object 
model  would  render  existing  projects  useless.  Several  different  approaches  could 
be  used  within  this  specific  case,  although  some  applications  and  their  datasets 
will  doubtlessly  experience  problems.  One  option  would  be  to  implement  the  next 
version  of  the  object  model  in  its  own  package  structure,  and  allowing  the  possi¬ 
bility  of  loading  two  versions  of  the  dataset  at  the  same  time.  A  utility  applica¬ 
tion  could  then  open  the  older  version  and  map  it  into  the  newer  version.  A  pos¬ 
sibly  better  approach  would  be  to  write  our  own  “output”  file,  in  XML  format  for 
example,  that  both  versions  would  be  able  to  read  and  write.  The  user  would 
open  the  old  versioned  project,  write  a  common  file,  open  a  blank  new  versioned 
project,  and  then  read  a  common  file. 
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4.  Less  frequent  database  transactions.  The  Building  Composer  core  library  takes 
care  of  most  database  transactions  needed  within  it.  One  of  the  problems  how¬ 
ever  is  that  in  critical,  time- sensitive  applications  or  sections  of  code  these  trans¬ 
actions  can  reduce  overall  system  performance.  This  was  a  concern  in  the  Layout 
Composer  application.  During  sections  of  code  that  deal  with  the  graphics  sys¬ 
tem  and  its  redrawing  of  a  graphical  element,  the  system  was  too  slow  to  present 
a  “smooth”  redraw  of  the  element.  To  alleviate  this,  the  Layout  Composer  appli¬ 
cation  maintains  an  internal  count  of  the  number  of  commands  performed.  Us¬ 
ing  this  count  the  Layout  Composer  application  starts  an  update  transaction  at 
count  one  and  then  commits  the  transaction  at  count  10.  This  change  greatly 
improved  the  redraw  rate  of  an  element.  The  drawback  of  this  solution  is  that,  if 
there  is  an  application  failure,  any  changes  done  since  the  last  transaction  com¬ 
mit  are  lost. 

Through  the  use  of  the  object  model  and  Building  Composer  core  library  it  is  pos¬ 
sible  to  write  many  applications  that  can  open,  modify,  and  close  a  facility  pro¬ 
ject.  The  object  model  was  written  to  be  an  open  model  that  can  be  used  directly 
through  methods  defined  by  the  IFC  object  model  or  through  custom  controller 
classes  developed.  The  Building  Composer  core  library  can  easily  be  used  as  a 
basis  for  a  final  application  and  can  be  hooked  into  to  receive  event  messages 
when  certain  actions  are  performed.  This  report  has  discussed  many  of  the  key 
concepts  and  classes  within  these  pieces. 
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Appendix  A:  IFC  1.50  EXPRESS  File 


SCHEMA  lfc150Final; 

--  IfcArchitecture  -  Type  Definitions 

TYPE  IfcSpaceProgramTypeEnum  =  ENUMERATION  OF  ( 

SpaceStandard 

.SpaceUnique); 

END_TYPE; 

-  IfcArchitecture  -  Entity  Definitions 
ENTITY  IfcSpaceProgramGroup 
SUBTYPE  OF  (IfcGroup); 

RequiredGroupArea :  OPTIONAL  IfcAreaMeasure; 

GroupRole  :  STRING; 

GroupAssignment  :  IfcActorSelect; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  SELFUfcGroup.GroupedBy.RelatedObjects  | 
'IFC150FINAL.IFCSPACEPROGRAM'  IN  TYPEOF(Temp)))  >=  1; 
END_ENTITY; 

ENTITY  IfcRelAdjacencyReq 
SUBTYPE  OF  (IfcRelationshipItol); 

--  SELF\lfcRelationship1to1  RelatingObject :  IfcSpaceProgram; 

--  SELF\lfcRelationship1  tol  RelatedObject  :  IfcSpaceProgram; 

RequiredAdjacency :  INTEGER; 

END_ENTITY; 

ENTITY  IfcSpaceProgram 
SUBTYPE  OF  (IfcControl); 

SpaceName  :  STRING; 

GenericType  :  IfcSpaceProgramTypeEnum; 

ProgramForSpaces  :  SET  [1:?]  OF  IfcSpace; 

INVERSE 

HasAdjacencyReqsTo  :  SET[0:?]  OF  IfcRelAdjacencyReq  FOR  RelatingObject; 
HasAdjacencyReqFrom  :  SET[0:?]  OF  IfcRelAdjacencyReq  FOR  RelatedObject; 
END_ENTITY; 

--  IfcDocumentExtension  -  TYPE  Definition 
TYPE  IfcCostElementOrGroupSelect  =  SELECT  ( 

IfcCostElementGroup 

.IfcCostElement); 

END_TYPE; 

--  IfcDocumentExtension  -  ENTITY  Definition 
ENTITY  IfcCostSchedule 
SUBTYPE  OF  (IfcDocument); 

ScheduleTitle :  STRING; 

SubmittedBy  :  OPTIONAL  IfcActorSelect; 

ApprovedBy  :  OPTIONAL  IfcPerson; 

PreparedBy  :  OPTIONAL  IfcPerson; 

SubmittedOn  :  OPTIONAL  IfcDateTimeSelect; 

Cost  :  OPTIONAL  IfcCost; 

HasCostElementGroup  :  LIST  [1:?]  OF  IfcCostElementGroup; 

END_ENTITY; 

ENTITY  IfcCostElementGroup 
SUBTYPE  OF  (IfcGroup); 

GroupTitle  :  OPTIONAL  STRING; 

GroupCos  :  OPTIONAL  IfcCost; 

PreparedOn  :  OPTIONAL  IfcDateTimeSelect; 

Groupld  :  OPTIONAL  STRING; 

INVERSE 

PartOfCostSchedule  :  IfcCostSchedule  FOR  HasCostElementGroup; 

WHERE 

WR1:  SIZEOF(QUERY(TEMP  <*  SELFMfcGroup.GroupedBy.RelatedObjects  | 
'IFC150FINAL. IFCCOSTELEMENT'  IN  TYPEOF(Temp)))  >=  1 ; 
END_ENTITY; 
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ENTITY  IfcCostElement 
SUBTYPE  OF  (IfcControl); 

Description  :  OPTIONAL  STRING; 

ElementCost  :  OPTIONAL  IfcCost; 

ExtensionCost  :  OPTIONAL  IfcCost; 

WHERE 

WR1:  SIZEOF(QUERY(TEMP  <*  SELRIfcObject.PartOfGroups  | 

'IFC150FINAL.IFCCOSTELEMENTGROUP'  IN  TYPEOF(Temp.RelatingObject)))  =  1; 
END_ENTITY; 

ENTITY  IfcRelCostScheduleElement 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELF\lfcRelationship1  toN.RelatedObjects  :  LIST  [1:?]  OF  IfcProduct; 

Quantity  :  NUMBER; 

WHERE 

('IFC150FINAL.IFCCOSTELEMENTGROUP'  IN  TYPEOF  (SELF\lfcRelationship1  toN  RelatingObject)) 
OR 

('IFC150FINAL. IFCCOSTELEMENT'  IN  TYPEOF  (SELFMfcRelationshipItoN. RelatingObject)); 
END_ENTITY; 

--  IfcFacilitiesMgmt  -  Cross  schema  references 

--  IfcFacilitiesMgmt  -  Type  Definitions 

TYPE  IfcFurnitureTypeEnum  =  ENUMERATION  OF  ( 

Table 
, Chair 
.Desk 

.FileCabinet); 

END_TYPE; 

--  IfcFacilitiesMgmt  -  Entity  Definitions 

ENTITY  IfcFurniture 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcFurnitureTypeEnum; 

AssignedTo  :  OPTIONAL  IfcActorSelect; 

END_ENTITY; 

--  IfcGeometryResource  -  Type  Definitions  for  Explicit 
TYPE  IfcDimensionCount  =  INTEGER; 

WHERE 

WR1:  { 0  <  SELF  <=3}; 

END_TYPE; 

TYPE  IfcT ransitionCode  =  ENUMERATION  OF  ( 

Discontinuous 

.Continuous 

.ContSameGradient 

.ContSameGradientSameCurvature); 

END_TYPE; 

TYPE  IfcTrimmingPreference  =  ENUMERATION  OF  ( 

Cartesian 

.Parameter 

.Unspecified); 

END_TYPE; 

TYPE  lfcAxis2Placement  =  SELECT  ( 
lfcAxis2Placement2D 
,lfcAxis2Placement3D); 

END_TYPE; 

TYPE  IfcT rimmingSelect  =  SELECT  ( 

IfcCartesianPoint 

JfcParameterValue); 

END_TYPE; 

TYPE  IfcVectorOrDirection  =  SELECT  ( 

IfcVector 

.IfcDirection); 

END_TYPE; 

--  IfcGeometryResource  -  Type  Definitions  for  Attribute  Driven 
TYPE  IfcProfileTypeEnum  =  ENUMERATION  OF  ( 

Curve 

.Area); 

END_TYPE; 

-  IfcGeometryResource  -  Entity  Definitions  for  Explicit 
ENTITY  IfcAxisI  Placement 
SUBTYPE  OF  (IfcPIacement); 
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Axis :  OPTIONAL  IfcDirection; 

DERIVE 
Z  :  IfcDirection 
:=  NVL  ( 

IfcNormalise(Axis) 

,lfcGeometricRepresentationltem()  ||  lfcDirection([0.0,0.0,1.0])); 
Dim :  IfcDimensionCount 
:=  3; 

WHERE 

WR1  :  (NOT  (EXISTS  (Axis)))  OR  (Axis.Dim  =  3); 

END_ENTITY; 

ENTITY  lfcAxis2Placement2D 
SUBTYPE  OF  (IfcPIacement); 

RefDirection  :  OPTIONAL  IfcDirection; 

DERIVE 

P  :  LIST  [2:2]  OF  IfcDirection 
:=  lfcBuild2Axes(RefDirection); 

Dim :  IfcDimensionCount 

:=  2; 

WHERE 

WR1:  (NOT  (EXISTS  (RefDirection)))  OR  (RefDirection.Dim  =  2); 
ENDJENTITY; 

ENTITY  lfcAxis2Placement3D 
SUBTYPE  OF  (IfcPIacement); 

Axis  :  OPTIONAL  IfcDirection; 

RefDirection  :  OPTIONAL  IfcDirection; 

DERIVE 

P  :  LIST  [3:3]  OF  IfcDirection 
:=  lfcBuildAxes(Axis,  RefDirection); 

Dim :  IfcDimensionCount 
:=  3; 

WHERE 

WR1:  SELF\lfcPlacement.Location.Dim  =  3; 

WR2:  (NOT  (EXISTS  (Axis)))  OR  (Axis.Dim  =  3); 

WR3:  (NOT  (EXISTS  (RefDirection)))  OR  (RefDirection.Dim  =  3); 
WR4:  (NOT  (EXISTS  (Axis)))  OR  (NOT  (EXISTS  (RefDirection)))  OR 
(lfcCrossProduct(Axis,  RefDirection).  Magnitude  >  0.0); 

WR5:  NOT  ((EXISTS  (Axis))  XOR  (EXISTS  (RefDirection))); 
ENDJENTITY; 

ENTITY  IfcBoundedCurve 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcPolyline 

JfcTrimmedCurve 

JfcCompositeCurve)) 

SUBTYPE  OF  (IfcCurve); 

ENDJENTITY; 

ENTITY  IfcBoundingBox 
SUBTYPE  OF  ( 

IfcGeometricRepresentationltem ); 

Position  :  lfcAxis2Placement3D; 

XDim  :  IfcPositiveLengthMeasure; 

YDim  :  IfcPositiveLengthMeasure; 

ZDim  :  IfcPositiveLengthMeasure; 

DERIVE 

Dim :  IfcDimensionCount 
:=  3; 

END_ENTITY; 

ENTITY  IfcCartesianPoint 
SUBTYPE  OF  (IfcPoint); 

Coordinates  :  LIST  [1 :3]  OF  IfcLengthMeasure; 

DERIVE 

Dim :  IfcDimensionCount 
:=  HIINDEX(Coordinates); 

WHERE 

WR1  :  HIINDEX(Coordinates)  >=  2; 

END_ENTITY; 

ENTITY  IfcCircle 
SUBTYPE  OF  (IfcConic); 
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Radius :  IfcPositiveLengthMeasure; 

END_ENTITY; 

ENTITY  IfcClosedShell 

SUBTYPE  OF  (IfcConnectedFaceSet); 

END_ENTITY; 

ENTITY  IfcCompositeCurve 

SUPERTYPE  OF  (ONEOF  (lfc2DCompositeCurve)) 

SUBTYPE  OF  (IfcBoundedCurve); 

Segments  :  LIST  [1 :?]  OF  IfcCompositeCurveSegment; 

Selflntersect :  LOGICAL; 

DERIVE 

NSegments  :  INTEGER 
:=  SIZEOF(Segments); 

ClosedCurve  :  LOGICAL 

:=  Segments[NSegments].' Transition  <>  Discontinuous; 

Dim :  IfcDimensionCount 
:=  Segmentsfll.Dim; 

WHERE 

WR1:  ((NOT  ClosedCurve)  AND  (SIZEOF(QUERY(Temp  <*  Segments  | 
Temp.Transition  =  Discontinuous))  =  1))  OR 
((ClosedCurve)  AND  (SIZEOF(QUERY(Temp  <*  Segments  | 
Temp.Transition  =  Discontinuous))  =  0)); 

WR2:  SIZEOF(  QUERY(  Temp  <*  Segments  |  Temp.Dim  <> 
Segments[1].Dim))  =  0; 

END_ENTITY; 

ENTITY  lfc2DCompositeCurve 
SUBTYPE  OF  (IfcCompositeCurve); 

WHERE 

WR1 :  SELFMfcCompositeCurve.ClosedCurve; 

WR2:  Dim  =  2; 

END_ENTITY; 

ENTITY  IfcCompositeCurveSegment 
SUBTYPE  OF  (IfcGeometricRepresentationltem); 

Transition  :  IfcT ransitionCode; 

SameSense  :  BOOLEAN; 

ParentCurve  :  IfcCurve; 

DERIVE 

Dim :  IfcDimensionCount 
:=  ParentCurve. Dim; 

INVERSE 

UsingCurves  :  BAG[1 :?]  OF  IfcCompositeCurve  FOR  Segments; 
WHERE 

WR1  :  ('IFC150FINAL. IFCBOUNDEDCURVE'  IN  TYPEOF(ParentCurve)); 
END_ENTITY; 

ENTITY  IfcConic 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcCircle 

JfcEllipse)) 

SUBTYPE  OF  (IfcCurve); 

Position :  lfcAxis2Placement; 

DERIVE 

Dim :  IfcDimensionCount 
:=  SELF. Position. Dim; 

END_ENTITY; 

ENTITY  IfcConnectedFaceSet 
SUPERTYPE  OF  (ONEOF(lfcClosedShell)) 

SUBTYPE  OF  (IfcTopologicalRepresentationltem); 

Cfs Faces  :  SET  [1 :?]  OF  IfcFace; 

END_ENTITY; 

ENTITY  IfcCurve 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcLine 
,  IfcConic 

.IfcBoundedCurve)) 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

END_ENTITY; 

ENTITY  IfcCurveBoundedPlane 
SUBTYPE  OF  (IfcSurface); 
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BasisSurface  :  IfcPIane; 

OuterBoundary  :  lfc2DCompositeCurve; 

InnerBoundaries  :  SET  [0:?]  OF  lfc2DCompositeCurve; 

DERIVE 

Dim :  IfcDimensionCount 
:=  SELF. BasisSurface. Dim; 

ENDJENTITY; 

ENTITY  IfcDirection 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

DirectionRatios  :  LIST  [2:3]  OF  REAL; 

DERIVE 

Dim :  IfcDimensionCount 
:=  HIINDEX(DirectionRatios); 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  DirectionRatios  |  Temp  <>  0.0))  >  0; 
END_ENTITY; 

ENTITY  IfcElementarySurface 

ABSTRACT  SUPERTYPE  OF  (ONEOF(lfcPlane)) 

SUBTYPE  OF  (IfcSurface); 

Position :  lfcAxis2Placement3D; 

DERIVE 

Dim :  IfcDimensionCount 
:=  Position. Dim; 

END_ENTITY; 

ENTITY  IfcEllipse 
SUBTYPE  OF  (IfcConic); 

SemiAxisI  :  IfcPositiveLengthMeasure; 

SemiAxis2 :  IfcPositiveLengthMeasure; 

END_ENTITY; 

ENTITY  IfcExtrudedAreaSolid 
SUBTYPE  OF  (IfcSweptAreaSolid); 

ExtrudedDirection :  IfcDirection; 

Depth :  IfcPositiveLengthMeasure; 

WHERE 

WR1:  IfcDotProductf 

(SELF\lfcSweptAreaSolid.SweptArea.BasisSurface\ 

IfcPIane. Position. P[3]),  ExtrudedDirection)  <>  0.0; 

ENDJENTITY; 

ENTITY  IfcFace 

SUBTYPE  OF  (IfcTopologicalRepresentationltem); 

Bounds  :  SET  [1:?]  OF  IfcFaceBound; 

WHERE 

WR2:  SIZEOF(QUERY(temp  <*  Bounds  |  'IFC150FINAL.IFCFACEOUTERBOUND' 
IN  TYPEOF(temp)))  <=  1; 

ENDJENTITY; 

ENTITY  IfcFaceBound 
SUPERTYPE  OF  (ONEOF( 

IfcFaceOuterBound)) 

SUBTYPE  OF  (IfcTopologicalRepresentationltem); 

Bound  :  IfcPolyLoop; 

Orientation  :  BOOLEAN; 

ENDJENTITY; 

ENTITY  IfcFaceOuterBound 
SUBTYPE  OF  (IfcFaceBound); 

END_ENTITY; 

ENTITY  IfcFacetedBrep 
SUBTYPE  OF  (IfcManifoldSolidBrep); 

ENDJENTITY; 

ENTITY  IfcFacetedBrepWithVoids 
SUBTYPE  OF  (IfcManifoldSolidBrep); 

Voids  :  SET  [1:?]  OF  IfcClosedShell; 

ENDJENTITY; 

ENTITY  IfcGeometricRepresentationltem 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcBoundingBox 
,  IfcPoint 
.IfcCurve 
.IfcDirection 
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.IfcPolyLoop 

.IfcPIacement 

JfcSurface 

.IfcCompositeCurveSegment 
,  IfcHalfSpaceSolid 
,  IfcSolidModel 
JfcVector )); 

ENDJENTITY; 

ENTITY  IfcHalfSpaceSolid 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

BaseSurface  :  IfcSurface; 

AgreementFlag  :  BOOLEAN; 

DERIVE 

Dim :  IfcDimensionCount 

:=  3; 

ENDJENTITY; 

ENTITY  IfcLine 
SUBTYPE  OF  (IfcCurve); 

Pnt :  IfcCartesianPoint; 

Dir :  IfcVector; 

DERIVE 

Dim :  IfcDimensionCount 
:=  Pnt.Dim; 

WHERE 

WR1  :  Dir.Dim  =  Pnt.Dim; 

ENDJENTITY; 

ENTITY  IfcManifoldSolidBrep 
ABSTRACT  SUPERTYPE  OF  (ONEOF  ( 

IfcFacetedBrep 

.IfcFacetedBrepWithVoids)) 

SUBTYPE  OF  (IfcSolidModel); 

Outer  :  IfcClosedShell; 

ENDJENTITY; 

ENTITY  IfcPIacement 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcAxisI  Placement 

,lfcAxis2Placement2D 

,lfcAxis2Placement3D)) 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

Location :  IfcCartesianPoint; 

ENDJENTITY; 

ENTITY  IfcPIane 

SUBTYPE  OF  (IfcElementarySurface); 

END_ENTITY; 

ENTITY  IfcPoint 

ABSTRACT  SUPERTYPE  OF  (ONEOF  (IfcCartesianPoint)) 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

END_ENTITY; 

ENTITY  IfcPolyline 
SUBTYPE  OF  (IfcBoundedCurve); 

Points  :  LIST  [2:?]  OF  IfcCartesianPoint; 

DERIVE 

Dim :  IfcDimensionCount 
:=  Points[1].Dim; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  Points  |  Temp.Dim  <>  Points[1].Dim)) 

=  0; 

ENDJENTITY; 

ENTITY  IfcPolyLoop 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

Polygon  :  LIST  [3:?]  OF  UNIQUE  IfcCartesianPoint; 

DERIVE 

Dim :  IfcDimensionCount 
:=  Polygon[1].Dim; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  Polygon  |  Temp.Dim  <>  Polygon[1].Dim)) 

=  0; 

END_ENTITY; 
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ENTITY  IfcRevolvedAreaSolid 
SUBTYPE  OF  (IfcSweptAreaSolid); 

Axis  :  IfcAxisI  Placement; 

Angle :  IfcPIaneAngleMeasure; 

DERIVE 

AxisLine :  IfcLine 

:=  lfcGeometricRepresentationltem()  ||  IfcLine 
(Axis. Location 

,lfcGeometricRepresentationltem()  ||  lfcVector(Axis.Z,1.0)); 

END_ENTITY; 

ENTITY  IfcSolidModel 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcManifoldSolidBrep 
, IfcSweptAreaSolid 
.IfcAttDrivenExtrudedSolid 
JfcAttDrivenRevolvedSolid)) 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

DERIVE 

Dim :  IfcDimensionCount 

:=  3; 

END_ENTITY; 

ENTITY  IfcSurface 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcElementarySurface 

.IfcCurveBoundedPlane)) 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

ENDJENTITY; 

ENTITY  IfcSweptAreaSolid 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcExtrudedAreaSolid 

.IfcRevolvedAreaSolid)) 

SUBTYPE  OF  (IfcSolidModel); 

SweptArea :  IfcCurveBoundedPlane; 

WHERE 

WR1:  'IFC150FINAL.IFCPLANE'  IN 
TYPEOF(SweptArea.BasisSurface); 

ENDJENTITY; 

ENTITY  IfcTopologicalRepresentationltem 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcConnectedFaceSet 

.IfcFace 

.IfcFaceBound)); 

ENDJENTITY; 

ENTITY  IfcTrimmedCurve 
SUBTYPE  OF  (IfcBoundedCurve); 

BasisCurve  :  IfcCurve; 

Triml  :  SET[1:2]  OF  IfcT rimmingSelect; 

T  rim2  :  SET[1 :2]  OF  IfcT  rimmingSelect; 

SenseAgreement  :  BOOLEAN; 

MasterRepresentation :  IfcTrimmingPreference; 

DERIVE 

Dim :  IfcDimensionCount 
:=  SELF. BasisCurve. Dim; 

WHERE 

WR1:  (HIINDEX(Triml)  =  1)  XOR  (TYPEOF(Trim1  [1])  <>  TYPEOF(Trim1[2])); 
WR2:  (HIINDEX(Trim2)  =  1)  XOR  (TYPEOF(Trim2[1])  <>  TYPEOF(Trim2[2])); 
WR3:  NOT('IFC150FINAL. IFCBOUNDEDCURVE'  IN  TYPEOF(SELF. BasisCurve)); 
ENDJENTITY; 

ENTITY  IfcVector 

SUBTYPE  OF  (IfcGeometricRepresentationltem); 

Orientation  :  IfcDirection; 

Magnitude  :  IfcLengthMeasure; 

DERIVE 

Dim :  IfcDimensionCount 
:=  Orientation. Dim; 

WHERE 

WR1:  Magnitude  >=  0.0; 

END_ENTITY; 
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--  IfcGeometryResource  -  Entity  Definitions  for  AttDriven 
ENTITY  IfcAttDrivenExtrudedSolid 
SUPERTYPE  OF  (ONEOF  ( 

IfcAttDrivenClippedExtrudedSolid)) 

SUBTYPE  OF  (IfcSolidModel); 

Segments  :  LIST  [1 :?]  OF  IfcAttDrivenExtrudedSegment; 

DERIVE 

Path  :  IfcPolyline 

:=  IfcExtrusionPath(SELF); 

WHERE 

WR1 :  SIZEOF(QUERY(  Temp  <*  Segments  | 

Temp.Position.Axis  <>  Seg ments[  1  ] .Position . Axi s)) 

=  0; 

ENDJENTITY; 

ENTITY  IfcAttDrivenClippedExtrudedSolid 
SUBTYPE  OF  (IfcAttDrivenExtrudedSolid); 

ClippingHalfSpaces  :  LIST  [1:2]  OF  IfcHalfSpaceSolid; 

ENDJENTITY; 

ENTITY  IfcAttDrivenExtrudedSegment 

SUPERTYPE  OF  (ONEOF(lfcAttDrivenMorphedExtrudedSegment,lfcAttDrivenTaperedExtrudedSegment)) 
SUBTYPE  OF  (IfcExtrudedAreaSolid); 

Position  :  lfcAxis2Placement3D; 

ProfileDef  :  IfcAttDrivenProfileDef; 

DERIVE 

SELF\lfcSweptAreaSolid.SweptArea :  IfcCurveBoundedPlane 
:=  IfcProfilelntoArea(ProfileDef); 

SELF\lfcExtrudedAreaSolid.ExtrudedDirection :  IfcDirection 

:=  IfcGeometricRepresentationltemO  ||  lfcDirection([0.0,0.0,1.0]); 

INVERSE 

PartOfSolid  :  IfcAttDrivenExtrudedSolid  FOR  Segments; 

END_ENTITY; 

ENTITY  IfcAttDrivenT aperedExtrudedSegment 
SUBTYPE  OF  (IfcAttDrivenExtrudedSegment); 

TaperingFactor  :  IfcPositiveRatioMeasure; 

ENDJENTITY; 

ENTITY  IfcAttDrivenMorphedExtrudedSegment 
SUBTYPE  OF  (IfcAttDrivenExtrudedSegment); 

EndProfileDef  :  IfcAttDrivenProfileDef; 

DERIVE 

EndSweptArea  :  IfcCurveBoundedPlane 

:=  IfcProfilelntoArea(EndProfileDef); 

WHERE 

WR1 :  TYPEOF(SELF\lfcAttDrivenExtrudedSegment.ProfileDef)  =  TYPEOF(EndProfileDef); 

WR2:  NOT('IFC150FINAL.IFCARBITRARYPROFILEDEF' 

IN  TYPEOF(SELF\lfcAttDrivenRevolvedSegment.ProfileDef)); 

WR3:  SELF\lfcAttDrivenExtrudedSegment.ProfileDef.Position.P[1]  =  EndProfileDef.  Position .  P[1  ]; 

END  ENTITY; 

ENTITY  IfcAttDrivenRevolvedSolid 
SUPERTYPE  OF  (ONEOF  ( 

IfcAttDrivenClippedRevolvedSolid)) 

SUBTYPE  OF  (IfcSolidModel); 

Segments  :  LIST  [1:?]  OF  IfcAttDrivenRevolvedSegment; 

DERIVE 

Path  :  IfcTrimmedCurve 

:=  IfcRevolutionPath(SELF); 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  Segments  | 

Temp. Position  :<>:  Segments[1], Position)) 

=  0; 

WR2:  SIZEOF(QUERY(  Temp  <*  Segments  | 

Temp\lfcRevolvedAreaSolid.Axis  <>  Segments[1]\lfcRevolvedAreaSolid.Axis)) 

=  0; 

ENDJENTITY; 

ENTITY  IfcAttDrivenClippedRevolvedSolid 
SUBTYPE  OF  (IfcAttDrivenRevolvedSolid); 

ClippingHalfSpaces  :  LIST  [1:2]  OF  IfcHalfSpaceSolid; 

ENDJENTITY; 

ENTITY  IfcAttDrivenRevolvedSegment 
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SUPERTYPE  OF  (ONEOF(lfcAttDrivenMorphedRevolvedSegment,lfcAttDrivenTaperedRevolvedSegment)) 
SUBTYPE  OF  (IfcRevolvedAreaSolid); 

Position  :  lfcAxis2Placement3D; 

StartAngle  :  IfcPIaneAngleMeasure; 

ProfileDef  :  IfcAttDrivenProfileDef; 

DERIVE 

SELF\lfcSweptAreaSolid.SweptArea :  IfcCurveBoundedPlane 
:=  IfcProfilelntoArea(ProfileDef); 

INVERSE 

PartOfSolid  :  IfcAttDrivenRevolvedSolid  FOR  Segments; 

WHERE 

WR1:  SELF\lfcRevolvedAreaSolid.Axis!ocation.Coordinates[3]  =  0; 

END_ENTITY; 

ENTITY  IfcAttDrivenT aperedRevolvedSegment 
SUBTYPE  OF  (IfcAttDrivenRevolvedSegment); 

TaperingFactor  :  IfcPositiveRatioMeasure; 

END_ENTITY; 

ENTITY  IfcAttDrivenMorphedRevolvedSegment 
SUBTYPE  OF  (IfcAttDrivenRevolvedSegment); 

EndProfileDef  :  IfcAttDrivenProfileDef; 

DERIVE 

EndSweptArea  :  IfcCurveBoundedPlane 

:=  IfcProfilelntoArea(EndProfileDef); 

WHERE 

WR1 :  TYPEOF(SELF\lfcAttDrivenRevolvedSegment.ProfileDef)  =  TYPEOF(EndProfileDef); 

WR2:  NOT('IFC150FINAL.IFCARBITRARYPROFILEDEF' 

IN  TYPEOF(SELF\lfcAttDrivenRevolvedSegment.ProfileDef)); 

WR3:  SELF\lfcAttDrivenRevolvedSegment.ProfileDef.Position.P[1]  =  EndProfileDef.Position.P[1]; 
END_ENTITY; 

ENTITY  IfcAttDrivenProfileDef 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcRectangleProfileDef 
,  IfcCircleProfileDef 
,lfcT  rapeziumProfileDef 
JfcArbitraryProfileDef)); 

Position  :  lfcAxis2Placement2D; 

ProfileType  :  IfcProfileTypeEnum; 

DERIVE 

PositionToOrigin  :  LIST[2:2]  OF  IfcLengthMeasure 
:=  Position. Location.Coordinates; 

AnglelnOrigin  :  IfcPIaneAngleMeasure 

:=  lfcComputeAngleFromAxis(Position.P[11); 

END_ENTITY; 

ENTITY  IfcArbitraryProfileDef 
SUBTYPE  OF  (IfcAttDrivenProfileDef); 

CurveForSurface :  IfcBoundedCurve; 

WHERE 

WR1:  (('IFC150FINAL.IFCPOLYLINE'  IN 

TYPEOF(CurveForSurface))  AND  (CurveForSurface. Dim  =  2)) 

OR 

(('IFC1 50FINAL.IFCTRIMMEDCURVE'  IN 
TYPEOF(CurveForSurface))  AND  (CurveForSurface. Dim  =  2)) 

OR 

(('IFC150FINAL.IFCCOMPOSITECURVE'  IN 
TYPEOF(CurveForSurface))  AND  (CurveForSurface. Dim  =  2)); 

END_ENTITY; 

ENTITY  IfcCircleProfileDef 
SUBTYPE  OF  (IfcAttDrivenProfileDef); 

Radius  :  IfcPositiveLengthMeasure; 

DERIVE 

CurveForSurface  :  IfcTrimmedCurve 

:=  IfcCircleProfilelntoCurve(SELF); 

END_ENTITY; 

ENTITY  IfcRectangleProfileDef 
SUBTYPE  OF  (IfcAttDrivenProfileDef); 

XDim :  IfcPositiveLengthMeasure; 

YDim :  IfcPositiveLengthMeasure; 

DERIVE 
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CurveForSurface  :  IfcPolyline 

:=  IfcRectangleProfilelntoCurve(SELF); 

ENDJENTITY; 

ENTITY  IfcTrapeziumProfileDef 
SUBTYPE  OF  (IfcAttDrivenProfileDef); 

BottomXDim  :  IfcPositiveLengthMeasure; 

TopXDim  :  IfcPositiveLengthMeasure; 

YDim  :  IfcPositiveLengthMeasure; 

TopXOffset  :  IfcLengthMeasure; 

DERIVE 

CurveForSurface  :  IfcPolyline 

:=  IfcT  rapeziumProfilelntoCurve(SELF); 

ENDJENTITY; 

--  IfcGeometryResource  -  Function  Definition  for  Explicit 
FUNCTION  IfcBuildAxes  ( 

Axis,  RefDirection  :  IfcDirection) 

:  LIST  [3:3]  OF  IfcDirection; 

LOCAL 

U  :  LIST  [3:3]  OF  IfcDirection 

:=  [IfcGeometricRepresentationltemO  ||  lfcDirection([1. 0,0.0, 0.0]) 
,lfcGeometricRepresentationltem()  ||  lfcDirection([0. 0,1. 0,0.0]) 
,lfcGeometricRepresentationltem()  jj  lfcDirection([0. 0,0. 0,1.0])]; 
END_LOCAL; 

U[3]  :=  NVL(lfcNormalise(Axis) 

,lfcGeometricRepresentationltem()  ||  lfcDirection([0.0,0.0,1.0])); 
U[1]  :=  lfcFirstProjAxis(U[3],  RefDirection); 

U[2]  :=  lfcNormalise(lfcCrossProduct(U[3],U[1  ])). Orientation; 
RETURN(U); 

END_FUNCTION; 

FUNCTION  lfcBuild2Axes  ( 

RefDirection :  IfcDirection) 

:  LIST  [2:2]  OF  IfcDirection; 

LOCAL 

U  :  LIST[2:2]  OF  IfcDirection 

:=  [lfcGeometricRepresentationltem()  ||  lfcDirection([1 .0,0.0]) 
,lfcGeometricRepresentationltem()  ||  lfcDirection([0. 0,1.0])]; 
END_LOCAL; 

U[1]  :=  NVL(lfcNormalise(RefDirection) 

,lfcGeometricRepresentationltem()  ||  lfcDirection([1 .0,0.0])); 
U[2]  :=  lfcOrthogonalComplement(U[1]); 

RETURN(U); 

END_FUNCTION; 

FUNCTION  IfcCrossProduct  ( 

Argl,  Arg2 :  IfcDirection) 

:  IfcVector; 

LOCAL 

Mag  :  REAL  :=  0.0; 

V1.V2  :  LIST[3:3]  OF  REAL  :=  [0.0:3]; 

Res  :  IfcDirection 

:=  lfcGeometricRepresentationltem()  ||  lfcDirection([1. 0,0. 0,0.0]); 
Result :  IfcVector 

:=  lfcGeometricRepresentationltem()  ||  IfcVector  ( 

lfcGeometricRepresentationltem()  j|  lfcDirection([1. 0,0.0, 0.0]) 

,1.0); 

END_LOCAL; 

IF  (  NOT  EXISTS  (Argl)  OR  (Argl. Dim  =  2))  OR 
(  NOT  EXISTS  (Arg2)  OR  (Arg2.Dim  =  2))  THEN 
RETURN(?); 

ELSE 

BEGIN 

VI  :=  lfcNormalise(Arg1).DirectionRatios; 

V2  :=  lfcNormalise(Arg2).DirectionRatios; 

Res.DirectionRatiosfl]  :=  (V1[2]*V2[3]  -v1[3]*v2[2]); 

Res .  D  i  recti  on  Rati  os[2]  :=  (V1[3]‘V2[1]  -v1[1]*v2[3]); 

Res .  D  i  recti  on  Rati  os[3]  :=  (V1[1]*V2[2]  -v1[2]‘v2[1]); 

Mag  :=  0.0; 

REPEAT  i  :=  1  TO  3; 

Mag  :=  Mag  +  Res . D i rectio n Ratios [i]* Res .D i rection Ratios[i] ; 
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ENDJREPEAT; 

IF  (Mag  >  0.0)  THEN 
Result.Orientation  :=  Res; 

Result.Magnitude  :=SQRT(Mag); 

ELSE 

Result.Orientation  :=  Argl ; 

Result.Magnitude  :=  0.0; 

ENDJF; 

RETURN(Result); 

END; 

ENDJF; 

END_FUNCTION; 

FUNCTION  IfcDotProduct  (Argl,  Arg2  :  IfcDirection) 

:  REAL; 

LOCAL 

Scalar  :  REAL  :=  0.0; 

Ndim  :  INTEGER  :=0; 

Vecl  ,Vec2 :  IfcDirection 

:=  lfcGeometricRepresentationltem()  ||  lfcDirection([1. 0,0.0, 0.0]); 
ENDJ.OCAL; 

IF  NOT  EXISTS  (Argl)  OR  NOT  EXISTS  (Arg2)  THEN 
Scalar  :=  ?; 

ELSE 

IF  (Argl. dim  <>  Arg2.dim)  THEN 
Scalar  :=  ?; 

ELSE 

BEGIN 

Vecl  :=  IfcNormalise(Argl); 

Vec2  :=  lfcNormalise(Arg2); 

Ndim  :=  Argl. Dim; 

Scalar  :=  0.0; 

REPEAT  i  :=  1  TO  Ndim; 

Scalar  :=  Scalar  + 

Vecl .  D  i  rection  Rati  os[i]  * 

Vec2.DirectionRatios[ij; 

ENDJREPEAT; 

END; 

ENDJF; 

ENDJF; 

RETURN  (Scalar); 

END_FUNCTION; 

FUNCTION  IfcFirstProjAxis  (ZAxis,  Arg  :  IfcDirection) 

:  IfcDirection; 

LOCAL 

XAxis,  V,  Z  :  IfcDirection 

:=  lfcGeometricRepresentationltem()  ||  lfcDirection([1 .0,0.0,0  0]); 
XVec  :  IfcVector 

:=  lfcGeometricRepresentationltem()  ||  IfcVector  ( 

lfcGeometricRepresentationltem()  ||  lfcDirection([1. 0,0.0, 0.0]) 

,1.0); 

ENDJ.OCAL; 

IF  (NOT  EXISTS(ZAxis))  OR  (NOT  EXISTS(Arg))  OR  (Arg. Dim  <>  3)  THEN 
XAxis  :=  ?; 

ELSE 

ZAxis  :=  IfcNormalise(ZAxis); 

IF  NOT  EXISTS(Arg)  THEN 
IF  (ZAxis  <>  lfcDirection([1. 0,0.0, 0.0]))  THEN 

V  :=  IfcGeometricRepresentationltemQ  ||  lfcDirection([1. 0,0.0, 0.0]); 
ELSE 

V  :=  IfcGeometricRepresentationltemQ  ||  lfcDirection([0.0,1 .0,0.0]); 
ENDJF; 

ELSE 

IF  ((lfcCrossProduct(Arg,Z). Magnitude)  =  0.0)  THEN 
RETURN  (?); 

ELSE 

V  :=  IfcNormalise(Arg); 

ENDJF; 

ENDJF; 
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XVec  :=  lfcScalarTimesVector(lfcDotProduct(V,Z),  ZAxis); 

XAxis  :=  lfcVectorDifference(V,  XVec). Orientation; 

XAxis  :=  IfcNormalise(XAxis); 

ENDJF; 

RETURN(XAxis); 

END_FUNCTION; 

FUNCTION  IfcNormalise  ( 

Arg :  IfcVectorOrDirection) 

:  IfcVectorOrDirection; 

LOCAL 

Ndim  :  INTEGER  :=0; 

Mag  :  REAL  :=  0.0; 

V  :  IfcDirection 

:=  lfcGeometricRepresentationltem()  ||  lfcDirection([1 . 0,0.0, 0.0]); 
Vec  :  IfcVector 

:=  lfcGeometricRepresentationltem()  ||  IfcVector) 

lfcGeometricRepresentationltem()  j|  lfcDirection([1 . 0,0.0, 0.0]) 

,1.0); 

Result  :  IfcVectorOrDirection 

:=  V; 

END_LOCAL; 

IF  NOT  EXISTS  (Arg)  THEN 
Result  :=  ?; 

ELSE 

Ndim  :=  Arg. Dim; 

IF  'IFC150FINAL. IFCVECTOR'  IN  TYPEOF(Arg)  THEN 
BEGIN 
Vec  :=  Arg; 

V  :=  Arg.Orientation; 

IF  Arg. Magnitude  =  0.0  THEN 
RETURN(?); 

ELSE 

Vec. Magnitude  :=  1.0; 

ENDJF; 

END; 

ELSE 
V  :=  Arg; 

ENDJF; 

Mag  :=  0.0; 

REPEAT  i  :=  1  TO  Ndim; 

Mag  :=  Mag  +  V.DirectionRatios[i]  *  V.DirectionRatiosp]; 
ENDJREPEAT; 

IF  Mag  >0.0  THEN 
Mag  :=  SQRT(Mag); 

REPEAT  i  :=  1  TO  Ndim; 

V.DirectionRatiosp]  :=  V.DirectionRatiosp]/Mag; 

END_REPEAT; 

IF  'IFC150FINAL. IFCVECTOR’  IN  TYPEOF(Arg)  THEN 
Vec.Orientation  :=  V; 

Result  :=  Vec; 

ELSE 

Result  :=  V; 

ENDJF; 

ELSE 

RETURN(?); 

ENDJF; 

ENDJF; 

RETURN  (Result); 

END_FUNCTION; 

FUNCTION  IfcOrthogonalComplement  ( 

Vec :  IfcDirection) 

:  IfcDirection; 

LOCAL 

Result :  IfcDirection 

:=  lfcGeometricRepresentationltem()  ||  lfcDirection([1. 0,0.0, 0.0]); 
ENDJ.OCAL; 

IF  (Vec. Dim  <>  2)  OR  NOT  EXISTS  (Vec)  THEN 
RETURN(?); 
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ELSE 

Result.DirectionRatios[1]  :=  -Vec.DirectionRatios[2]; 

Result.DirectionRatios[2]  :=  Vec.DirectionRatios[lj; 

RETURN(result); 

ENDJF; 

END_FUNCTION; 

FUNCTION  IfcScalarTimesVector  ( 

Scalar :  REAL; 

Vec  :  IfcVectorOrDirection) 

:  IfcVector; 

LOCAL 

Mag  :  REAL  :=  0.0; 

V  :  IfcDirection 

:=  lfcGeometricRepresentationltem()  ||  lfcDirection([1. 0,0. 0,0.0]); 

Result :  IfcVector 

:=  lfcGeometricRepresentationltem()  ||  IfcVector  ( 

lfcGeometricRepresentationltem()  j|  lfcDirection([1. 0,0.0, 0.0]) 

,1.0); 

END_LOCAL; 

IF  NOT  EXISTS  (Scalar)  OR  NOT  EXISTS  (Vec)  THEN 
Result  :=  ?; 

ELSE 

IF  'IFC150FINAL. IFCVECTOR'  IN  TYPEOF  (Vec)  THEN 

V  :=  Vec. Orientation; 

Mag  :=  Scalar  *  Vec. Magnitude; 

ELSE 

V  :=Vec; 

Mag  :=  Scalar; 

ENDJF; 

IF  (Mag  <0.0  (THEN 

REPEAT  i  :=  1  TO  SIZEOF(V.DirectionRatios); 

V.DirectionRatiosfi]  :=  -V.DirectionRatios[i]; 

ENDJREPEAT; 

Mag  :=  -Mag; 

ENDJF; 

Result.Orientation  :=  IfcNormalise(V); 

Result.Magnitude  :=  Mag; 

END_IF; 

RETURN  (Result); 

END_FUNCTION; 

FUNCTION  IfcVectorDifference  ( 

Argl ,  Arg2  :  IfcVectorOrDirection) 

:  IfcVector; 

LOCAL 

Mag,  Magi ,  Mag2  :  REAL  :=  0.0; 

Ndim  :  INTEGER  :=0; 

Res,  Vecl ,  Vec2  :  IfcDirection 

:=  IfcGeometricRepresentationltemQ  ||  lfcDirection([1. 0,0.0, 0.0]); 

Result  :  IfcVector 

:=  lfcGeometricRepresentationltem()  ||  IfcVector  ( 

lfcGeometricRepresentationltem()  ||  lfcDirection([1. 0,0.0, 0.0]) 

,1.0); 

ENDJ.OCAL; 

IF  ((NOT  EXISTS  (Argl))  OR  (NOT  EXISTS  (Arg2)))  OR  (Argl. Dim  <>  Arg2.Dim)  THEN 
Result  :=  ?; 

ELSE 

BEGIN 

IF  'IFC150FINAL. IFCVECTOR’  IN  TYPEOF(Argl)  THEN 
Magi  :=  Argl. Magnitude; 

Vecl  :=  Argl. Orientation; 

ELSE 

Magi  :=  1.0; 

Vecl  :=  Argl; 

ENDJF; 

IF  'IFC150FINAL. IFCVECTOR’  IN  TYPEOF(Arg2)  THEN 
Mag2  :=  Arg2. Magnitude; 

Vec2  :=  Arg2. Orientation; 

ELSE 
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Mag2  :=  1.0; 

Vec2  :=  Arg2; 

ENDJF; 

Vecl  :=  IfcNormalise  (Vecl); 

Vec2  :=  IfcNormalise  (Vec2); 

Ndim  :=  SIZEOF(Vec1  .DirectionRatios); 

Mag  :=  0.0; 

REPEAT  i  :=  1  TO  Ndim; 

Res.DirectionRatios[i]  :=  Magi  *  Vecl . D i rection Ratios[i]  - 
Mag2  *  Vec2.DirectionRatios[i]; 

Mag  :=  Mag  +  (Res.DirectionRatios[i]  *  Res  .Direction  Ratios[i]); 
ENDJREPEAT; 

IF  (Mag  >0.0)  THEN 
Result.Magnitude  :=  SQRT(Mag); 

Result.Orientation  :=  Res; 

ELSE 

Result.Magnitude  :=  0.0; 

Result.Orientation  :=  Vecl; 

ENDJF; 

END; 

ENDJF; 

RETURN  (Result); 

END_FUNCTION; 

--  IfcGeometryResource  -  Function  Definition  for  AttDriven 
FUNCTION  IfcCircleProfilelntoCurve  ( 

ProfileDef :  IfcCircleProfileDef) 

:  IfcTrimmedCurve; 

LOCAL 

Pos  :  lfcAxis2Placement2D; 

Circle  :  IfcCircle; 

ResCurve :  IfcTrimmedCurve; 

ENDJ.OCAL; 

Pos  :=  ProfileDef\lfcAttDrivenProfileDef.Position; 

Circle  :=  lfcGeometricRepresentationltem()  ||  IfcConic(Pos)  || 

IfcCi  rcle(ProfileDef .  Radi  us) ; 

ResCurve  :=  lfcGeometricRepresentationltem()  ||  lfcBoundedCurve()  || 
lfcTrimmedCurve( 

Circle,  [0.0],  [2*PI],  TRUE,  Parameter); 

RETURN  (ResCurve); 

END_FUNCTION; 

FUNCTION  IfcRectangleProfilelntoCurve  ( 

ProfileDef :  IfcRectangleProfileDef) 

:  IfcPolyline; 

LOCAL 

Points  :  LIST  [4:4]  OF  IfcCartesianPoint 
:=  [IfcGeometricRepresentationltemO  || 
lfcCartesianPoint([0.0,0.0]):4] ; 

TempDir  :  IfcDirection 

:=  lfcGeometricRepresentationltem()  || 
lfcDirection([1 .0,0.0]); 

ResCurve  :  IfcPolyline; 

ENDJ.OCAL; 

Points[1]  :=  ProfileDefMfcAttDrivenProfileDef.Position. Location; 
TempDir  :=  ProfileDef\lfcAttDrivenProfileDef.Position.P[1]; 

Points[2]  :=  IfcPointT ranslation  (Points[1], 

lfcGeometricRepresentationltem()  ||  IfcVector  ( 

TempDir,  ProfileDef.XDim )); 

TempDir  :=  IfcOrthogonalComplement(TempDir); 

Points[3]  :=  IfcPointT ranslation  (Points[2], 

lfcGeometricRepresentationltem()  ||  IfcVector  ( 

TempDir,  ProfileDef.YDim )); 

TempDir  :=  IfcOrthogonalComplement(TempDir); 

Points[4]  :=  IfcPointT ranslation  (Points[3], 

lfcGeometricRepresentationltem()  ||  IfcVector  ( 

TempDir,  ProfileDef.XDim )); 

ResCurve  :=  lfcGeometricRepresentationltem()  || 

lfcPolyline([Points[1], Points  [2], Points  [3], Points[4],Points[1]]); 
RETURN  (ResCurve); 
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END_FUNCTION; 

FUNCTION  IfcTrapeziumProfilelntoCurve  ( 

ProfileDef :  IfcTrapeziumProfileDef) 

:  IfcPolyline; 

LOCAL 

Points  :  LIST  [4:4]  OF  IfcCartesianPoint 
:=  [IfcGeometricRepresentationltemQ  || 
lfcCartesianPoint([0.0,0.0]):4] ; 

TempDir  :  IfcDirection 

:=  lfcGeometricRepresentationltem()  || 
lfcDirection([1 .0,0.0]); 

TempPoint :  IfcCartesianPoint 

:=  lfcGeometricRepresentationltem()  || 
lfcCartesianPoint([0.0,0,0]); 

ResCurve  :  IfcPolyline; 

END_LOCAL; 

Points[1]  :=  ProfileDef\lfcAttDrivenProfileDef.Position. Location; 

TempDir  :=  ProfileDef\lfcAttDrivenProfileDef.Position.P[1]; 

Points[2]  :=  IfcPointT ranslation  (Points[1], 

lfcGeometricRepresentationltem()  ||  IfcVector  ( 

TempDir,  ProfileDef.BottomXDim )); 

TempDir  :=  IfcOrthogonalComplement(TempDir); 

TempPoint  :=  IfcPointT ranslation  (Points[2], 

lfcGeometricRepresentationltem()  ||  IfcVector  ( 

TempDir,  ProfileDef.YDim )); 

TempDir  :=  IfcOrthogonalComplement(TempDir); 

Points[3]  :=  IfcPointT ranslation  (TempPoint, 

!fcGeometricRepresentationltem()  ||  IfcVector  ( 

TempDir, 

(ProfileDef.BottomXDim  -  ProfileDef. TopXDim  -  ProfileDef.TopXOffset ))); 

Points[4]  :=  IfcPointT ranslation  (Points[3], 

lfcGeometricRepresentationltem()  ||  IfcVector  ( 

TempDir,  ProfileDef. TopXDim )); 

ResCurve  :=  lfcGeometricRepresentationltem()  || 

lfcPolyline([Points[1], Points  [2], Points  [3], Points[4],Points[1]]); 

RETURN  (ResCurve); 

END_FUNCTION; 

FUNCTION  IfcProfilelntoArea  ( 

ProfileDef :  IfcAttDrivenProfileDef) 

:  IfcCurveBoundedPlane; 

LOCAL 

Curve2D  :  lfc2DCompositeCurve; 

ResSurface:  IfcCurveBoundedPlane; 

END_LOCAL; 

Curve2D  :=  lfcGeometricRepresentationltem()  || 
lfcCurve()  || 
lfcBoundedCurve()  || 
lfcCompositeCurve( 

[IfcCompositeCurveSegment  (Continuous, 

TRUE,  ProfileDef.CurveForSurface)],  FALSE)  || 
lfc2DCompositeCurve(); 

ResSurface  :=  lfcGeometricRepresentationltem()  || 
lfcSurface()  || 
lfcCurveBoundedPlane( 

lfcGeometricRepresentationltem()  ||  lfcSurface()  ||  lfcElementarySurface( 
lfcGeometricRepresentationltem()  ||  lfcPlacement( 
lfcGeometricRepresentationltem()  || 
lfcCartesianPoint([0.0,  0.0,  0.0]))  || 
lfcAxis2Placement3D( 

lfcGeometricRepresentationltem()  ||  lfcDirection([0. 0,0. 0,1.0]), 
lfcGeometricRepresentationltem()  ||  lfcDirection([1. 0,0.0, 0.0])))  || 
lfcPlane(), 

Curve2D,  []); 

RETURN  (ResSurface); 

END_FUNCTION; 

FUNCTION  IfcComputeAngleFromAxis  ( 

Dir :  IfcDirection) 

:  IfcPIaneAngleMeasure; 
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LOCAL 

Angle  :  IfcPIaneAngleMeasure; 

ENDJ.OCAL; 

IF  (Dir.Dim  <>  2)  OR  (NOT  EXISTS  (Dir))  THEN 
RETURN  (?); 

ENDJF; 

Angle  :=  ATAN(Dir.DirectionRatios[2],  Dir.DirectionRatios[1]); 

IF  (Dir.DirectionRatiosfl]  <  0.0)  THEN 
Angle  :=  Angle  +  PI; 

ELSE 

IF  (Dir.DirectionRatios[2]  <  0.0)  THEN 
Angle  :=  Angle  +  2  *  PI; 

ENDJF; 

ENDJF; 

RETURN  (Angle); 

END_FUNCTION; 

FUNCTION  IfcPointT ranslation  ( 

Origin :  IfcCartesianPoint; 

Vec  :  IfcVector) 

:  IfcCartesianPoint; 

LOCAL 

NDim  :  INTEGER  :=  HIINDEX(Origin.Coordinates); 

Point  :  IfcCartesianPoint 

:=  lfcGeometricRepresentationltem()  || 
lfcCartesianPoint([0. 0,0.0]); 

ENDJ.OCAL; 

IF  (Origin. Dim  <>  Vec.Dim)  OR  (NOT  EXISTS  (Vec))  OR  (NOT  EXISTS  (Origin))  THEN 
RETURN  (?); 

ENDJF; 

REPEAT  i  :=  1  TO  NDim; 

Point.Coordinates[i]  :=  Origin.Coordinatesp]  + 

Vec. Magnitude  *  Vec.Orientation . Di rectio n Ratios[i] ; 

ENDJREPEAT; 

RETURN  (Point); 

END_FUNCTION; 

FUNCTION  IfcExtrusionPath  ( 

Solid  :  IfcAttDrivenExtrudedSolid) 

:  IfcPolyline; 

LOCAL 

Path  :  IfcPolyline 

:=  lfcGeometricRepresentationltem()  ||  lfcCurve()  ||  lfcBoundedCurve()  || 

lfcPolyline([lfcGeometricRepresentationltem()  ||  lfcPoint()  ||  lfcCartesianPoint([0.0,0.0,0.0]), 
lfcGeometricRepresentationltem()  ||  lfcPoint()  ||  lfcCartesianPoint([0.0,0.0,1.0])]); 

Depth  :  IfcPositiveLengthMeasure  :=  0; 

NDim  :  INTEGER  :=  HIINDEX(Solid.Segments); 

END_LOCAL; 

REPEAT  i  :=  1  TO  NDim; 

Depth  :=  Depth  +  Solid.Segmentsli], Depth; 

ENDJREPEAT; 

Path  :=  lfcGeometricRepresentationltem()  ||  IfcCurveQ  ||  lfcBoundedCurve()  || 
lfcPolyline([Solid.Segments[1]. Position. Location, 

IfcPointT ranslation  (Sol  id  .Segments  [1  ] .  Position .  Location , 
lfcGeometricRepresentationltem()  ||  IfcVector  ( 

Solid.Segments[1].Position.Axis,  Depth))]); 

RETURN(Path); 

END_FUNCTION; 

FUNCTION  IfcRevol ution Path  ( 

Solid  :  IfcAttDrivenRevolvedSolid) 

:  IfcTrimmedCurve; 

LOCAL 

Path  JfcTrimmedCurve; 

Pos  :  lfcAxis2Placement3D; 

Circle :  IfcCircle; 

Angle  :  IfcPIaneAngleMeasure  :=  0; 

NDim  :  INTEGER  :=  HIINDEX(Solid.Segments); 

ENDJ.OCAL; 

REPEAT  i  :=  1  TO  NDim; 

Angle  :=  Angle  +  Solid.Segments[i].Angle; 
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ENDJREPEAT; 

Pos  :=  lfcGeometricRepresentationltem()  ||  IfcPIacement  ( 

lfcGeometricRepresentationltem()  ||  IfcPointf)  ||  lfcCartesianPoint([ 

(Solid.  Segments[1],  Position.  Location.Coordinates[1]  +  Solid.Segments[1].Axis.Location.Coordinates[1]) 
.(Solid.Segmentsjl  ].  Position.  Location.Coordinates[2]  +  Solid.Segments[1].Axis.Location.Coordinates[lj) 
.(Solid.Segmentsjl  j. Position. Location. Coordinates[3]  +  Solid. Segmentsjlj.Axis. Location. Coordinatesjlj)]))  || 
lfcAxis2Placement3D  ( 

lfcGeometricRepresentationltem()  ||  lfcDirection([0.0,1 .0,0.0]), 
lfcGeometricRepresentationltem()  ||  lfcDirection([-1 . 0,0.0, 0.0])); 

Circle  :=  lfcGeometricRepresentationltem()  ||  IfcConic(Pos)  || 

lfcCircle(Solid.Segments[1].Axis.Location.Coordinates[1  ]); 

Path  :=  lfcGeometricRepresentationltem()  ||  lfcBoundedCurve()  || 
lfcTrimmedCurve( 

Circle,  [0.0],  [Angle],  TRUE,  Parameter); 

RETURN  (Path); 

END_FUNCTION; 

--  IfcKernel  -  Type  Definitions 

TYPE  IfcProxyTypeEnum  =  ENUMERATION  OF  ( 

Product 
.Process 
.Control 
.Document 
.Resource ); 

END_TYPE; 

TYPE  IfcSequenceT ypeEnum  =  ENUMERATION  OF  ( 

Start_Start 
,Start_Finish 
,Finish_Start 
,Finish_Finish ); 

END_TYPE; 

TYPE  IfcObjectWithPlacementSelect  =  SELECT  ( 

IfcProduct 
.IfcModelingAid 
,  IfcProject); 

END_TYPE; 

-  IfcKernel  -  Entity  Definitions 
ENTITY  IfcControl 

ABSTRACT  SUPERTYPE  OF  (ONEOF  (IfcConnectionGeometry.lfcCostElement.lfcSpaceProgram.lfcWorkSchedule)) 
SUBTYPE  OF  (IfcObject); 

END_ENTITY; 

ENTITY  IfcDocument 
ABSTRACT  SUPERTYPE 
SUBTYPE  OF  (IfcObject); 

END_ENTITY; 

ENTITY  IfcGroup 

SUPERTYPE  OF  (ONEOF  (IfcCostElementGroup.lfcSpaceProgramGroup.lfcSystem.lfcWorkGroup.lfcZone)) 

SUBTYPE  OF  (IfcObject); 

GroupPurpose  :  OPTIONAL  STRING; 

INVERSE 

GroupedBy  :  IfcRelGroups  FOR  RelatingObject; 

ENDJENTITY; 

ENTITY  IfcLocalPlacement 
SUBTYPE  OF  (IfcModelingAid); 

PlacementRelTo  :  OPTIONAL  IfcObjectWithPlacementSelect; 

RelativePlacement  :  lfcAxis2Placement; 

END_ENTITY; 

ENTITY  IfcModelingAid 
ABSTRACT  SUPERTYPE  OF  (ONEOF 

(IfcLocalPlacement, IfcDesignGrid.lfcGridAxis.lfcGridlntersection.lfcGridLevel.lfcPIacementConstraint.lfcReferenceGeometryAid)) 
SUBTYPE  OF  (IfcRoot); 

END_ENTITY; 

ENTITY  IfcObject 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcProduct 

.IfcProcess 

.IfcControl 

.IfcDocument 

.IfcGroup 
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,  IfcProject 

.IfcProxy 

JfcResource)) 

SUBTYPE  OF  (IfcRoot); 

OwnerHistory  :  IfcOwnerHistory; 

TypeDefinitions  :  LIST  [0:?]  OF  IfcPropertyT ypeDef ; 

OccurrenceProperties  :  LIST  [0:?]  OF  IfcOccurrencePropertySet; 

ExtendedProperties  :  LIST  [0:?]  OF  IfcPropertySet; 

INVERSE 

PartOfGroups  :  SET  [0:?]  OF  IfcRelGroups 

FOR  RelatedObjects; 

WHERE 

WR1:  SIZEOF(QUERY(temp  <*  ExtendedProperties  | 

('IFC150FINAL. IFCOCCURRENCEPROPERTYSET'  IN  TYPEOF(temp)) 

OR 

('IFC150FINAL.IFCSHAREDPROPERTYSET'  IN  TYPEOF(temp)))) 

=  0; 

END_ENTITY; 

ENTITY  IfcProcess 
ABSTRACT  SUPERTYPE 
SUBTYPE  OF  (IfcObject); 

PerformedBy  :  SET  [0:?]  OF  IfcActorSelect; 

Classification  :  OPTIONAL  IfcClassificationList; 

INVERSE 

IsSuccessorFrom  :  SET  [0:?]  OF  IfcRelSequence 
FOR  RelatedObject; 

IsPredecessorTo  :  SET  [0:?]  OF  IfcRelSequence 
FOR  RelatingObject; 

UsesProducts  :  SET  [0:2]  OF  IfcRelUsesProducts 
FOR  RelatingObject; 

END_ENTITY; 

ENTITY  IfcProduct 

ABSTRACT  SUPERTYPE  OF  (ONEOF  (lfcBuilding,lfcBuildingStorey,lfcElement,lfcSite,lfcSpatialElement)) 
SUBTYPE  OF  (IfcObject); 

LocalPlacement  :  IfcLocalPlacement; 

ProductShape  :  OPTIONAL  IfcProductShape; 

ProductCost  :  OPTIONAL  IfcCost; 

Classification  :  OPTIONAL  IfcClassificationList; 

INVERSE 

UsedlnProcesses  :  SET  [0:?]  OF  IfcRelUsesProducts 
FOR  RelatedObjects; 

END_ENTITY; 

ENTITY  IfcProject 
SUBTYPE  OF  (IfcObject); 

Globalld  :  OPTIONAL  IfcGloballyUniqueld; 

UnitsInContext  :  IfcUnitAssignment; 

ProjectTeam  :  IfcProjectTeamRegistry; 

ProjectApps  :  IfcProjectAppRegistry; 

Classification  :  OPTIONAL  IfcClassificationList; 

AbsolutePlacement  :  lfcAxis2Placement; 

END_ENTITY; 

ENTITY  IfcProxy 
SUBTYPE  OF  (IfcObject); 

ProxyType  :  IfcProxyTypeEnum; 

LocalPlacement  :  OPTIONAL  IfcLocalPlacement; 

ProductShape  :  OPTIONAL  IfcProductShape; 

WHERE 

WR1 :  NOT(EXISTS(SELF\lfcObject.TypeDefinitions)); 

WR2:  HIINDEX(SELF\lfcObject.OccurrenceProperties)  =  0; 

WR3:  ((ProxyType  =  IfcProxyTypeEnum. Product)  AND  (EXISTS(LocalPlacement))) 

OR 

((ProxyType  <>  IfcProxyTypeEnum. Product)  AND  NOT(EXISTS(LocalPlacement))); 

ENDJENTITY; 

ENTITY  IfcRelationship 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcRelationshipItoN 
JfcRelationshipl  tol )) 

SUBTYPE  OF  (IfcRoot); 
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OwnerHistory  :  IfcOwnerHistory; 

ExtendedProperties  :  LIST  [0:?]  OF  IfcPropertySet; 

Related IsDependent  :  BOOLEAN; 

RelatinglsDependent  :  BOOLEAN; 

END_ENTITY; 

ENTITY  IfcRelationshipItol 

ABSTRACT  SUPERTYPE  OF  (ONEOF  (IfcRelSequenceJfcRelAdjacencyReq.lfcRelConnectsElements.lfcRelResourceUse)) 
SUBTYPE  OF  (IfcRelationship); 

RelatingObject  :  IfcObject; 

RelatedObject  :  IfcObject; 

WHERE 

WR1:  RelatedObject  :<>:  RelatingObject; 

END_ENTITY; 

ENTITY  IfcRelationshipItoN 
ABSTRACT  SUPERTYPE  OF  (ONEOF 

(lfcRelGroups,lfcRelUsesProducts,lfcRelAssemblesElements,lfcRelAssemblesSpaces,lfcRelContains,lfcRelCostScheduleElement,lfc 

RelCoversBldgElements,lfcRelFillsElements,lfcRelSeparatesSpaces,lfcRelServicesBuildings,lfcRelVoidsElements)) 

SUBTYPE  OF  (IfcRelationship); 

RelatingObject  :  IfcObject; 

RelatedObjects  :  LIST  [1 :?]  OF  IfcObject; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  RelatedObjects  | 

RelatingObject  :=:  Temp))  =  0; 

END_ENTITY; 

ENTITY  IfcRelGroups 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELF\lfcRelationship1toN. RelatingObject :  IfcGroup; 

--  SELF\lfcRelationship1toN. RelatedObjects  :  LIST  [1:?]  OF  IfcObject; 

ENDJENTITY; 

ENTITY  IfcRelSequence 
SUBTYPE  OF  (IfcRelationshipItol); 

--  SELFMfcRelationshipl tol. RelatingObject :  IfcProcess; 

--  SELFMfcRelationshipItol. RelatedObject  :  IfcProcess; 

TimeLag  :  IfcTimeDurationMeasure; 

SequenceType  :  IfcSequenceTypeEnum; 

END_ENTITY; 

ENTITY  IfcRelUsesProducts 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELFMfcRelationshipl toN. RelatingObject :  IfcProcess; 

--  SELFMfcRelationshipl  toN. RelatedObjects  :  LIST  [1:?]  OF  IfcProduct; 

InOrOut :  LOGICAL; 

END_ENTITY; 

ENTITY  IfcResource 
SUBTYPE  OF  (IfcObject); 

END_ENTITY; 

ENTITY  IfcRoot 

ABSTRACT  SUPERTYPE  OF(  ONEOF( 

IfcObject 

.IfcRelationship 

.IfcModelingAid)); 

Projectld  :  IfcProjectUniqueld; 

UNIQUE 
UR1:  Projectld; 

END_ENTITY; 

-  IfcMeasureResource  -  Type  Definition  for  Unit  and  Measure 
TYPE  IfcAmountOfSubstanceMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcAreaMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcContextDependentMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcCountMeasure  =  NUMBER; 

END_TYPE; 

TYPE  IfcDescriptiveMeasure  =  STRING; 

END_TYPE; 

TYPE  IfcElectricCurrentMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcLengthMeasure  =  REAL; 
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END_TYPE; 

TYPE  IfcLuminousIntensityMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcMassMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcNumericMeasure  =  NUMBER; 

END_TYPE; 

TYPE  IfcParameterValue  =  REAL; 

END_TYPE; 

TYPE  IfcPositiveLengthMeasure  =  IfcLengthMeasure; 

WHERE 
WR1:  SELF  >  0; 

END_TYPE; 

TYPE  IfcPositivePlaneAngleMeasure  =  IfcPIaneAngleMeasure; 

WHERE 

WR1:  SELF  >  0; 

END_TYPE; 

TYPE  IfcPositiveRatioMeasure  =  IfcRatioMeasure; 

WHERE 
WR1:  SELF  >  0; 

END_TYPE; 

TYPE  IfcPIaneAngleMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcRatioMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcSolidAngleMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcThermodynamicTemperatureMeasure  =  REAL; 
END_TYPE; 

TYPE  IfcTimeMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcTimeDurationMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcTimeStamp  =  INTEGER; 

END_TYPE; 

TYPE  IfcVolumeMeasure  =  REAL; 

END_TYPE; 

TYPE  IfcCompoundPlaneAngleMeasure  =  LIST  [3:3]  OF  INTEGER; 
WHERE 

WR1 :  { 0  <=  SELF[1]  <  360 }; 

WR2:  { 0  <=  SELF[2]  <  60 }; 

WR3:  { 0  <=  SELF[3]  <  60 }; 

END_TYPE; 

TYPE  IfcBoolean  =  BOOLEAN; 

END_TYPE; 

TYPE  Ifclnteger  =  INTEGER; 

END_TYPE; 

TYPE  IfcReal  =  REAL; 

END_TYPE; 

TYPE  IfcString  =  STRING; 

END_TYPE; 

TYPE  IfcSi Prefix  =  ENUMERATION  OF  ( 

EXA 

,PETA 

,TERA 

,GIGA 

,MEGA 

,KILO 

,HECTO 

,DECA 

,DECI 

,CENTI 

.MILLI 

.MICRO 

,NANO 

,PICO 

.FEMTO 

,ATTO ); 
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END_TYPE; 

TYPE  IfcSiUnitName  =  ENUMERATION  OF  ( 

METRE 

,SQUARE_METRE 

.CUBICJV1ETRE 

,GRAM 

.SECOND 

.AMPERE 

.KELVIN 

.MOLE 

.CANDELA 

.RADIAN 

.STERADIAN 

.HERTZ 

.NEWTON 

.PASCAL 

.JOULE 

.WATT 

.COULOMB 

.VOLT 

.FARAD 

,OHM 

.SIEMENS 

.WEBER 

.TESLA 

.HENRY 

,DEGREE_CELSIUS 

.LUMEN 

,LUX 

.BECQUEREL 

.GRAY 

.SIEVERT); 

END_TYPE; 

TYPE  IfcDerivedUnitTypeEnum  =  ENUMERATION  OF  ( 
VolumetricFlowrateUnit 
.MassFlowrateUnit 
.PressureUnit 
.EnergyUnit 
.PowerUnit 
.AngularVelocityUnit 
.LinearVelocityUnit 
.RotationalFrequencyUnit 
.HeatfluxDensityUnit 
.MassDensityUnit 
.ThermalResistanceUnit 
.ThermalTransmittanceUnit 
.VoltageUnit 
.DynamicViscosityUnit 
.KinematicViscosityUnit 
.Unspecified); 

END_TYPE; 

TYPE  IfcUnitTypeEnum  =  ENUMERATION  OF  ( 
LengthUnit 
.MassUnit 
.TimeUnit 
.DurationUnit 
.ElectricCurrentUnit 
.ThermodynamicTemperatureUnit 
.AmountOfSubstanceUnit 
.LuminousIntensityUnit 
.PlaneAngleUnit 
.SolidAngleUnit 
.AreaUnit 
.VolumeUnit 
.RatioUnit 
.Unspecified ); 

END_TYPE; 

TYPE  IfcMeasureValue  =  SELECT  ( 
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IfcLengthMeasure 

.IfcMassMeasure 

JfcTimeMeasure 

JfcElectricCurrentMeasure 

JfcThermodynamicTemperatureMeasure 

JfcAmountOfSubstanceMeasure 

JfcLuminousIntensityMeasure 

JfcPIaneAngleMeasure 

JfcSolidAngleMeasure 

JfcAreaMeasure 

JfcVolumeMeasure 

JfcRatioMeasure 

JfcParameterValue 

.IfcNumericMeasure 

JfcContextDependentMeasure 

JfcDescriptiveMeasure 

JfcPositiveLengthMeasure 

,  IfcPositivePlaneAngleMeasure 

,  IfcPositiveRatioMeasure 

JfcCountMeasure 

JfcCompoundPlaneAngleMeasure 

JfcTimeDurationMeasure 

JfcTimeStamp); 

END_TYPE; 

TYPE  IfcUnit  =  SELECT  ( 

IfcDerivedUnit 
,  IfcNamedUnit ); 

END_TYPE; 

--  IfcMeasureResource  -  Entity  Definition  for  Unit  and  Measure 
ENTITY  IfcConversionBasedUnit 
SUBTYPE  OF  (IfcNamedUnit); 

Name  :  STRING; 

ConversionFactor :  IfcMeasureWithUnit; 

END_ENTITY; 

ENTITY  IfcContextDependentUnit 
SUBTYPE  OF  (IfcNamedUnit); 

Name  :  STRING; 

END_ENTITY; 

ENTITY  IfcDerivedUnit; 

Elements  :  SET  [1 :?]  OF  IfcDerivedUnitElement; 
UnitType  :  IfcDerivedUnitTypeEnum; 

DERIVE 

Dimensions  :  IfcDimensionalExponents 

:=  IfcDeriveDimensionalExponents(SELF); 

WHERE 

WR1:  (SIZEOF  (Elements)  >  1) 

OR  ((SIZEOF  (Elements)  =  1) 

AND  (Elements[1], Exponent  <>  1 )); 

END_ENTITY; 

ENTITY  IfcDerivedUnitElement; 

Unit  :  IfcNamedUnit; 

Exponent  :  INTEGER; 

END_ENTITY; 

ENTITY  IfcDimensionalExponents; 

LengthExponent  :  INTEGER; 

MassExponent  :  INTEGER; 

TimeExponent  :  INTEGER; 

ElectricCurrentExponent  :  INTEGER; 
ThermodynamicTemperatureExponent :  INTEGER; 
AmountOfSubstanceExponent  :  INTEGER; 
LuminousIntensityExponent  :  INTEGER; 

END_ENTITY; 

ENTITY  IfcMeasureWithUnit; 

ValueComponent :  IfcMeasureValue; 

UnitComponent  :  IfcUnit; 

END_ENTITY; 

ENTITY  IfcNamedUnit 
SUPERTYPE  OF  (ONEOF( 
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IfcSiUnit 

JfcConversionBasedUnit 
JfcContextDependentUnit )); 

Dimensions  :  IfcDimensionalExponents; 

UnitType  :  IfcUnitTypeEnum; 

WHERE 

WR1 :  IfcCorrectDimensions 
(SELF. UnitType,  SELF. Dimensions); 

END_ENTITY; 

ENTITY  IfcSiUnit 
SUBTYPE  OF  (IfcNamedUnit); 

Prefix  :  OPTIONAL  IfcSiPrefix; 

Name  :  IfcSiUnitName; 

DERIVE 

SELFMfcNamedUnit.Dimensions 
:  IfcDimensionalExponents 
:=  IfcDimensionsForSiUnit  (SELF. Name); 

END_ENTITY; 

ENTITY  IfcUnitAssignment; 

Units:  SET  [1:?]  OF  IfcUnit; 

END_ENTITY; 

--  IfcMeasureResource  -  Function  Definition  for  Unit  and  Measure 
FUNCTION  IfcDeriveDimensionalExponents  ( 
x :  IfcUnit) 

:  IfcDimensionalExponents; 

LOCAL 

Result :  IfcDimensionalExponents  := 

lfcDimensionalExponents(0,  0,  0,  0,  0,  0,  0); 

ENDJ.OCAL; 

IF  'IFC150FINAL.IFCDERIVEDUNIT'  IN  TYPEOF(x)  THEN 
REPEAT  i  :=  LOINDEX(x.Elements)  TO  HIINDEX(x.Elements); 
Result.LengthExponent  := 

Result.LengthExponent  + 

(x. Elementsp]. Exponent  * 
x.Elementspj.Unit.Dimensions.LengthExponent); 

Result.MassExponent  := 

Result.MassExponent  + 

(x. Elementsp], Exponent* 
x.Elements[i].Unit.Dimensions.MassExponent); 

Result.TimeExponent  := 

Result.TimeExponent  + 

(x. Elementsp], Exponent  * 
x.Elementspj.Unit.Dimensions.TimeExponent); 
Result.ElectricCurrentExponent  := 

Result.ElectricCurrentExponent  + 

(x. Elementsp], Exponent  * 

x.Elementspj.Unit.Dimensions.ElectricCurrentExponent); 
Result.ThermodynamicTemperatureExponent  := 
Result.ThermodynamicTemperatureExponent  + 

(x. Elementsp], Exponent  * 

x.Elementspj.Unit.Dimensions.ThermodynamicTemperatureExponent); 
Result.AmountOfSubstanceExponent  := 
Result.AmountOfSubstanceExponent  + 

(x. Elementsp], Exponent  * 

x.Elementspj.Unit.Dimensions.AmountOfSubstanceExponent); 
Result.LuminousIntensityExponent  := 

Result.LuminousIntensityExponent  + 

(x. Elementsp], Exponent  * 

x.Elementspj.Unit.Dimensions.LuminousIntensityExponent); 

END_REPEAT; 

ELSE  --  x  is  a  unitless  or  a  named  unit 
Result  :=  x.Dimensions; 

ENDJF; 

RETURN  (Result); 

END_FUNCTION; 

FUNCTION  IfcDimensionsForSiUnit 
(n :  IfcSiUnitName ) 

:  IfcDimensionalExponents; 
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CASE  n  OF 

METRE  :  RETURN  (IfcDimensionalExponents 

(1,0,  0,0,  0,  0,  0)); 

SQUAREJVIETRE  :  RETURN  (IfcDimensionalExponents 

(2,  0,  0,  0,  0,  0,  0)); 

CUBICJV1ETRE  :  RETURN  (IfcDimensionalExponents 
(3,  0,0,0,  0,  0,  0)); 

GRAM  :  RETURN  (IfcDimensionalExponents 

(0, 1,0,  0,0,  0,0)); 

SECOND  :  RETURN  (IfcDimensionalExponents 

(0,0, 1,0,  0,0,0)); 

AMPERE  :  RETURN  (IfcDimensionalExponents 

(0,  0,0, 1,0,0,  0)); 

KELVIN  :  RETURN  (IfcDimensionalExponents 

(0,0,0,0,1,0,0)); 

MOLE  :  RETURN  (IfcDimensionalExponents 

(0,  0,0,0,  0, 1,0)); 

CANDELA  :  RETURN  (IfcDimensionalExponents 

(0,  0,0,0,  0,  0, 1)); 

RADIAN  :  RETURN  (IfcDimensionalExponents 

(0,  0,  0,  0,  0,  0,  0)); 

STERADIAN  :  RETURN  (IfcDimensionalExponents 

(0,  0,  0,  0,  0,  0,  0)); 

HERTZ  :  RETURN  (IfcDimensionalExponents 

(0,0, -1,0,  0,0,0)); 

NEWTON  :  RETURN  (IfcDimensionalExponents 

(1,1, -2,0,  0,0,0)); 

PASCAL  :  RETURN  (IfcDimensionalExponents 

(-1, 1,-2,  0,  0,0,0)); 

JOULE  :  RETURN  (IfcDimensionalExponents 

(2, 1,-2,  0,0,  0,0)); 

WATT  :  RETURN  (IfcDimensionalExponents 

(2,1, -3,0,  0,  0,  0)); 

COULOMB  :  RETURN  (IfcDimensionalExponents 

(0,  0, 1, 1,0,0,  0)); 

VOLT  :  RETURN  (IfcDimensionalExponents 

(2, 1,-3, -1,0,  0,0)); 

FARAD  :  RETURN  (IfcDimensionalExponents 

(-2, -1,4, 1,0,  0,0)); 

OHM  :  RETURN  (IfcDimensionalExponents 

(2, 1,-3, -2,  0,0,0)); 

SIEMENS  :  RETURN  (IfcDimensionalExponents 
(-2, -1,3,  2,  0,0,0)); 

WEBER  :  RETURN  (IfcDimensionalExponents 

(2, 1,-2, -1,0,  0,0)); 

TESLA  :  RETURN  (IfcDimensionalExponents 

(0, 1,-2, -1,0,  0,0)); 

HENRY  :  RETURN  (IfcDimensionalExponents 

(2, 1,-2, -2,  0,0,0)); 

DEGREEJSELSIUS  :  RETURN  (IfcDimensionalExponents 

(0,  0,0,0, 1,0,  0)); 

LUMEN  :  RETURN  (IfcDimensionalExponents 

(0,  0,0,0,  0,  0, 1)); 

LUX  :  RETURN  (IfcDimensionalExponents 

(-2,0,  0,  0,  0,  0,1)); 

BECQUEREL  :  RETURN  (IfcDimensionalExponents 

(0,  0,  -1,0,  0,  0,  0)); 

GRAY  :  RETURN  (IfcDimensionalExponents 

(2,  0,  -2,  0,  0,  0,  0)); 

SIEVERT  :  RETURN  (IfcDimensionalExponents 

(2,  0,  -2,  0,  0,  0,  0)); 

OTHERWISE  :  RETURN  (IfcDimensionalExponents 

(0,  0,  0,  0,  0,  0,  0)); 

END_CASE; 

END_FUNCTION; 

FUNCTION  IfcCorrectDimensions 
(m  :  IfcUnitTypeEnum; 

Dim :  IfcDimensionalExponents) 
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:  LOGICAL; 

CASE  m  OF 
LengthUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(1,0,  0,0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

MassUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(0, 1,0,0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

TimeUnit :  IF 

Dim  =  (IfcDimensionalExponents 
(0,  0, 1,0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

ElectricCurrentUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(0,  0,0, 1,0,0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

ThermodynamicTemperatureUnit :  IF 
Dim  =  (IfcDimensionalExponents 
(0,  0,0,0, 1,0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

AmountOfSubstanceUnit :  IF 
Dim  =  (IfcDimensionalExponents 
(0,  0,0,0,  0, 1,0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

LuminousIntensityUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(0,  0,0,0,  0,  0, 1)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

PlaneAngleUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(0,  0,  0,  0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

SolidAngleUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(0,  0,  0,  0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

AreaUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(2,  0,  0,  0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 
ENDJF; 

VolumeUnit :  IF 

Dim  =  (IfcDimensionalExponents 
(3,  0,  0,  0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 


ENDJF; 
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RatioUnit :  IF 

Dim  =  (IfcDimensionalExponents 

(0,  0,  0,  0,  0,  0,  0)) 

THEN  RETURN(TRUE); 

ELSE  RETURN(FALSE); 

ENDJF; 

OTHERWISE  : 

RETURN  (UNKNOWN); 

END„CASE; 

END_FUNCTION; 

--  IfcModelingAidExtension  -  Cross  schema  references  -- 
--  IfcModelingAidExtension  -  Type  definitions  -- 
TYPE  IfcReferenceCurveSelect  =  SELECT 
(IfcReferenceCurve, 

IfcGridAxis); 

END_TYPE; 

TYPE  IfcReferencePointSelect  =  SELECT 
(IfcGridlntersection, 

IfcReferencePoint); 

END_TYPE; 

--  IfcModelingAidExtension  -  Entity  definitions  -- 
ENTITY  IfcConstrainedPlacement 

SUBTYPE  OF  (IfcLocalPlacement); 

PathEndPointsConstraint :  LIST  [1:2]  OF  IfcPIacementConstraint; 

END_ENTITY; 

ENTITY  IfcConstraintRellntersection 

SUBTYPE  OF  (IfcPIacementConstraint); 

RefPointAt :  IfcReferencePointSelect; 

OffsetFromCurves  :  LIST  [0:3]  OF  IfcReferenceCurveSelect; 

OffsetDistances  :  LIST  [0:3]  OF  IfcLengthMeasure; 

END_ENTITY; 

ENTITY  IfcDesignGrid 

SUBTYPE  OF  (IfcModelingAid); 

GridPurpose :  STRING; 

LocalPlacement :  IfcLocalPlacement; 

INVERSE 

HasGridLevels  :  SET[1 :?]  OF  IfcGridLevel  FOR  PartOfDesignGrid; 

END_ENTITY; 

ENTITY  IfcGridAxis 

SUBTYPE  OF  (IfcModelingAid); 

PartOfGridLevel :  IfcGridLevel; 

AxisTag  :  STRING; 

AxisCurve :  IfcBoundedCurve; 

SameSense :  BOOLEAN; 

INVERSE 

AlignedGridlntersections  :  SET[0:?]  OF  IfcGridlntersection  FOR  AlignedWithAxes; 
END_ENTITY; 

ENTITY  IfcGridlntersection 

SUBTYPE  OF  (IfcModelingAid); 

AlignedWithAxes  :  SET  [2:?]  OF  IfcGridAxis; 

IntersectionPoint :  IfcCartesianPoint; 

ENDJENTITY; 

ENTITY  IfcGridLevel 

SUBTYPE  OF  (IfcModelingAid); 

PartOfDesignGrid :  IfcDesignGrid; 

GridLevelHeight :  IfcLengthMeasure; 

GridLevelName :  STRING; 

INVERSE 

HasGridAxes  :  SET[1 :?]  OF  IfcGridAxis  FOR  PartOfGridLevel; 

END_ENTITY; 

ENTITY  IfcPIacementConstraint 

ABSTRACT  SUPERTYPE  OF  (IfcConstraintRellntersection) 

SUBTYPE  OF  (IfcModelingAid); 

END_ENTITY; 

ENTITY  IfcReferenceCurve 

SUBTYPE  OF  (IfcReferenceGeometryAid); 

ReferenceCurve :  IfcBoundedCurve; 

END_ENTITY; 
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ENTITY  IfcReferencePoint 

SUBTYPE  OF  (IfcReferenceGeometryAid); 

ReferencePoint :  IfcCartesianPoint; 

END_ENTITY; 

ENTITY  IfcReferenceSurface 

SUBTYPE  OF  (IfcReferenceGeometryAid); 

ReferenceSurface :  IfcSurface; 

ENDJENTITY; 

ENTITY  IfcReferenceGeometryAid 

SUPERTYPE  OF  (ONEOF(lfcReferenceSurface,lfcReferenceCurve, IfcReferencePoint)) 
SUBTYPE  OF  (IfcModelingAid); 

LocalPlacement :  IfcLocalPlacement; 

END_ENTITY; 

--  IfcProcessExtension  -  Type  Definitions 
TYPE  IfcWorkTaskOrGroupSelect  =  SELECT  ( 

IfcWorkTask 
,  IfcWorkGroup); 

END_TYPE; 

TYPE  IfcTaskStatusEnum  =  ENUMERATION  OF  ( 

Completed 

.Started 

.NotYetStarted); 

END_TYPE; 

--  IfcProcessExtension  -  Entity  Definitions 
ENTITY  IfcRelResourceUse 
SUBTYPE  OF  (IfcRelationshipITol); 

ResourceQuantity  :  LIST  [1:?]  OF  REAL; 

ResourceDuration :  IfcTimeDurationMeasure; 

-  SELF\lfcRelationship1  tol  RelatingObject :  IfcProcess; 

-  SELF\lfcRelationship1  tol  RelatedObject  :  IfcResource; 

ENDJENTITY; 

ENTITY  IfcWorkGroup 
SUBTYPE  OF  (IfcGroup); 

WorkGroupName :  OPTIONAL  STRING; 

WorkGroups  :  OPTIONAL  STRING; 

WHERE 


WR1:  SIZEOF(QUERY(TEMP  <*  SELF\lfcGroup.GroupedBy.RelatedObjects  | 
'IFC150FINAL. IFCWORKTASK'  IN  TYPEOF(Temp)))  >=  1; 

ENDJENTITY; 

ENTITY  IfcWorkSchedule 


SUBTYPE  OF  (IfcControl); 

WorkSchedule  :  IfcWorkTaskOrGroupSelect; 
ActualStart  :  OPTIONAL  IfcDateTimeSelect; 

EarliestStart  :  OPTIONAL  IfcDateTimeSelect; 

LatestStart  :  OPTIONAL  IfcDateTimeSelect; 

ActualFinish  :  OPTIONAL  IfcDateTimeSelect; 

EarliestFinish  :  OPTIONAL  IfcDateTimeSelect; 

LatestFinish  :  OPTIONAL  IfcDateTimeSelect; 

StatusTime  :  OPTIONAL  IfcDateTimeSelect; 

ScheduledStart  :  OPTIONAL  IfcDateTimeSelect; 
ScheduledFinish  :  OPTIONAL  IfcDateTimeSelect; 
ScheduledDuration :  OPTIONAL  IfcTimeDurationMeasure; 
RemainingTime  :  OPTIONAL  IfcTimeDurationMeasure; 
FreeFloat  :  OPTIONAL  IfcTimeDurationMeasure; 

TotalFloat  :  OPTIONAL  IfcTimeDurationMeasure; 

TaskStatus  :  OPTIONAL  IfcTaskStatusEnum; 

IsCritical  :  OPTIONAL  BOOLEAN; 


ENDJENTITY; 
ENTITY  IfcWorkTask 


SUBTYPE  OF  (IfcProcess); 

WorkTaskld  :  OPTIONAL  STRING; 
TaskDescription  :  OPTIONAL  STRING; 
TaskCost  :  OPTIONAL  IfcCost; 

WorkMethod  :  OPTIONAL  STRING; 
END_ENTITY; 

--  IfcProductExtension  -  Type  Definitions 
TYPE  IfcBuildingTypeEnum  =  ENUMERATION  OF  ( 
Building ); 
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END_TYPE; 

TYPE  IfcBuildingStoreyTypeEnum  =  ENUMERATION  OF  ( 

BuildingStorey ); 

END_TYPE; 

TYPE  IfcConnectionTypeEnum  =  ENUMERATION  OF  ( 

AtPath 
.Start 
.AtEnd ); 

END_TYPE; 

TYPE  IfcContainmentTypeEnum  =  ENUMERATION  OF  ( 

ProjectContainer 

.SiteContainer 

.BuildingContainer 

.BuildingStoreyContainer 

.SpaceContainer); 

END_TYPE; 

TYPE  IfcElementFunctionTypeEnum  =  ENUMERATION  OF  ( 

Supporting 

.Enclosing 

.Servicing 

.Equipping); 

ENDJTYPE; 

TYPE  IfcOpeningTypeEnum  =  ENUMERATION  OF  ( 

Opening 
.Passage 
.Recess 
.Chase ); 

ENDJTYPE; 

TYPE  IfcSiteTypeEnum  =  ENUMERATION  OF  ( 

BuildingSite ); 

ENDJTYPE; 

TYPE  IfcSpaceTypeEnum  =  ENUMERATION  OF  ( 

Occupied 
.Technical 
.Circulation ); 

ENDJTYPE; 

TYPE  IfcSystemTypeEnum  =  ENUMERATION  OF  ( 

StructuralSystem 
.EnclosingSystem 
.DistributionSystem 
.FurnishingSystem 
.SpatialSystem ); 

ENDJTYPE; 

TYPE  IfcZoneTypeEnum  =  ENUMERATION  OF  ( 

Thermal 

.Daylighting 

.Equipment); 

ENDJTYPE; 

--  IfcProductExtension  -  Entity  Definitions 

ENTITY  IfcBuilding 

SUBTYPE  OF  (IfcProduct); 

GenericType  :  IfcBuildingTypeEnum; 
calcTotalHeight  :  OPTIONAL  IfcLengthMeasure; 
calcSiteCoverage :  OPTIONAL  IfcAreaMeasure; 
calcTotalVolume  :  OPTIONAL  IfcVolumeMeasure; 

INVERSE 

Contains  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatingObject; 

IsContainedBy  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatedObjects; 

ServicedBySystems:  SET  [0:?]  OF  IfcRelServicesBuildings  FOR  RelatedObjects; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

Temp.RelationshipType  =  ProjectContainer))  =  1; 

END_ENTITY; 

ENTITY  IfcBuildingElement 

ABSTRACT  SUPERTYPE  OF  (ONEOF 

(IfcBeam.lfcBuiltln.lfcColumn.lfcCovering.lfcDiscreteElement.lfcDistributionElement.lfcDoor.lfcElectricalAppliance.lfcEquipment.lfcFixt 

ure,lfcFloor,lfcFurniture,lfcRoofSlab,lfcWall,lfcWindow)) 

SUBTYPE  OF  (IfcElement); 
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HasMaterial  :  OPTIONAL  IfcMaterialSelect; 

INVERSE 

ProvidesBoundaries  :  SET  [0:?]  OF  IfcRelSeparatesSpaces  FOR  RelatingObject; 
END_ENTITY; 

ENTITY  IfcBuildingStorey 
SUBTYPE  OF  (IfcProduct); 

GenericType  :  IfcBuildingStoreyTypeEnum; 

Elevation  :  IfcLengthMeasure; 

calcTotalHeight  :  OPTIONAL  IfcLengthMeasure; 
calcTotalArea  :  OPTIONAL  IfcAreaMeasure; 
calcTotalVolume  :  OPTIONAL  IfcVolumeMeasure; 

INVERSE 

Contains  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatingObject; 

IsContainedBy  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatedObjects; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

Temp.RelationshipType  =  ProjectContainer))  =  1; 

WR2:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

Temp.RelationshipType  =  BuildingContainer))  =  1; 

ENDJENTITY; 

ENTITY  IfcElement 

ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcOpeningElement 

JfcBuildingElement)) 

SUBTYPE  OF  (IfcProduct); 

PerformedFunctions  :  SET  [0:?]  OF  IfcElementFunctionTypeEnum; 

INVERSE 

ConnectedTo  :  SET  [0:?]  OF  IfcRelConnectsElements  FOR  RelatingObject; 
ConnectedFrom  :  SET  [0:?]  OF  IfcRelConnectsElements  FOR  RelatedObject; 
HasOpenings  :  SET  [0:?]  OF  IfcRelVoidsElements  FOR  RelatingObject; 
FillsVoids  :  SET  [0:1]  OF  IfcRelFillsElements  FOR  RelatedObjects; 
IsAssemblyThrough  :  SET  [0:1]  OF  IfcRelAssemblesElements  FOR  RelatingObject; 
PartOfAssembly  :  SET  [0:1]  OF  IfcRelAssemblesElements  FOR  RelatedObjects; 
IsContainedBy  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatedObjects; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

Temp.RelationshipType  =  ProjectContainer))  =  1; 

WR2:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

(((Temp.RelationshipType  =  SiteContainer) 

OR  (Temp.RelationshipType  =  BuildingContainer) 

OR  (Temp.RelationshipType  =  BuildingStoreyContainer) 

OR  (Temp.RelationshipType  =  SpaceContainer)) 

AND  (Temp.ContainedOrReferenced  =  TRUE ))))  =  1; 

END_ENTITY; 

ENTITY  IfcOpeningElement 
SUBTYPE  OF  (IfcElement); 

GenericType  :  IfcOpeningTypeEnum; 

INVERSE 

VoidsElements  :  SET  [0:1]  OF  IfcRelVoidsElements  FOR  RelatedObjects; 
HasFillings  :  SET  [0:?]  OF  IfcRelFillsElements  FOR  RelatingObject; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELF\lfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcOpeningElement')))  =  0; 

END_ENTITY; 

ENTITY  IfcRelAssemblesElements 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELFMfcRelationshipItoN. RelatingObject :  IfcElement; 

--  SELFMfcRelationshipItoN. RelatedObjects  :  LIST  [1:?]  OF  IfcElement; 
END_ENTITY; 

ENTITY  IfcRelAssemblesSpaces 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELFMfcRelationshipItoN. RelatingObject :  IfcSpace; 

--  SELFMfcRelationshipItoN. RelatedObjects  :  LIST  [1:?]  OF  IfcSpace; 

END_ENTITY; 

ENTITY  IfcRelConnectsElements 
SUPERTYPE  OF  (ONEOF( 

IfcRelConnectsPathElements)) 

SUBTYPE  OF  (IfcRelationshipItol); 
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ConnectionGeometry  :  IfcConnectionGeometry; 

--  SELF\lfcRelationship1to1  RelatingObject :  IfcElement; 

--  SELF\lfcRelationship1  tol  RelatedObject  :  IfcElement; 

END_ENTITY; 

ENTITY  IfcRelConnectsPathElements 
SUBTYPE  OF  (IfcRelConnectsElements); 

RelatingPriorities  :  LIST  [0:RelatingLayerCount]  OF  INTEGER; 

RelatedPriorities  :  LIST  [CLRelatedLayerCount]  OF  INTEGER; 

RelatingConnectionType :  IfcConnectionTypeEnum; 

RelatedConnectionType  :  IfcConnectionTypeEnum; 

DERIVE 

RelatingLayerCount  :  INTEGER 

:=  IfcNoOfLayers(RelatingObject); 

RelatedLayerCount  :  INTEGER 

:=  IfcNoOfLayers(RelatedObject); 

END_ENTITY; 

ENTITY  IfcConnectionGeometry 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcPointConnectionGeometry)) 

SUBTYPE  OF  (IfcControl); 

ENDJENTITY; 

ENTITY  IfcPointConnectionGeometry 
SUBTYPE  OF  (IfcConnectionGeometry); 

PointOnRelatingElement :  IfcCartesianPoint; 

PointOnRelatedElement  :  OPTIONAL  IfcCartesianPoint; 

ENDJENTITY; 

ENTITY  IfcRelContains 
SUBTYPE  OF  (IfcRelationshipItoN); 

RelationshipType  :  IfcContainmentTypeEnum; 

ContainedOrReferenced  :  BOOLEAN; 

WHERE 

WR1:  ((RelationshipType  =  ProjectContainer)  AND 

('IFC1 50FINAL.IFCPROJECT'  IN  TYPEOF(SELF\lfcRelationship1  toN  RelatingObject))) 

XOR  (RelationshipType  <>  ProjectContainer); 

WR2:  ((RelationshipType  =  SiteContainer)  AND 

('IFC150FINAL.IFCSITE'  IN  TYPEOF(SELF\lfcRelationship1  toN.RelatingObject))  AND 
NOT('IFC150FINAL.IFCPROJECT'  IN  TYPEOF(SELF\lfcRelationship1  toN.RelatedObjects))) 

XOR  (RelationshipType  <>  SiteContainer); 

WR3:  ((RelationshipType  =  BuildingContainer)  AND 

('IFC150FINAL.IFCBUILDING'  IN  TYPEOF(SELRIfcRelationship1  toN.RelatingObject))  AND 
NOT('IFC1 50FINAL.IFCPROJECT'  IN  TYPEOF(SELF\lfcRelationship1  toN.RelatedObjects))  AND 
NOT('IFC1 50FINAL.IFCSITE'  IN  TYPEOF(SELF\lfcRelationship1  toN.RelatedObjects))) 

XOR  (RelationshipType  <>  BuildingContainer); 

WR4:  ((RelationshipType  =  BuildingStoreyContainer)  AND 

('IFC1 50FINAL.IFCBUILDINGSTOREY'  IN  TYPEOF(SELF\lfcRelationship1toN. RelatingObject))  AND 
NOT('IFC150FINAL.IFCPROJECT'  IN  TYPEOF(SELF\lfcRelationship1  toN.RelatedObjects))  AND 
NOT('IFC1 50FINAL.IFCSITE'  IN  TYPEOF(SELF\lfcRelationship1  toN  RelatedObjects))  AND 
NOT('IFC1 50FINAL.IFCBUILDING'  IN  TYPEOF(SELF\lfcRelationship1  toN  RelatedObjects))) 

XOR  (RelationshipType  <>  BuildingStoreyContainer); 

WR5:  ((RelationshipType  =  SpaceContainer)  AND 

('IFC150FINAL.IFCSPACE'  IN  TYPEOF(SELRIfcRelationship1  toN.RelatingObject))  AND 
NOT('IFC1 50FINAL.IFCPROJECT'  IN  TYPEOF(SELF\lfcRelationship1  toN.RelatedObjects))  AND 
NOT('IFC1 50FINAL.IFCSITE'  IN  TYPEOF(SELF\lfcRelationship1  toN  RelatedObjects))  AND 
NOT('IFC1 50FINAL.IFCBUILDING'  IN  TYPEOF(SELF\lfcRelationship1toN. RelatedObjects))  AND 
NOT('IFC150FINAL.IFCBUILDINGSTOREY'  IN  TYPEOF(SELF\lfcRelationship1  toN  RelatedObjects))) 
XOR  (RelationshipType  <>  SpaceContainer); 

END_ENTITY; 

ENTITY  IfcRelFillsElements 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELF\lfcRelationship1  toN.RelatingObject :  IfcOpeningElement; 

--  SELF\lfcRelationship1  toN.RelatedObjects  :  LIST  [1:?]  OF  IfcElement; 

WHERE 

WR1  :  SIZEOF  (QUERY  (temp  <*  SELFVfcRelationshipItoN. RelatedObjects  | 

'IFC150FINAL. IFCOPENINGELEMENT'  IN  TYPEOF(temp)))  =  0; 

END_ENTITY; 

ENTITY  IfcRelSeparatesSpaces 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELF\lfcRelationship1  toN.RelatingObject :  IfcBuildingElement; 
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--  SELF\lfcRelationship1  toN .  Related  Objects  :  LIST  [1:?]  OF  IfcSpaceBoundary; 
ENDJENTITY; 

ENTITY  IfcRelServicesBuildings 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELF\lfcRelationship1  toN.RelatingObject :  IfcSystem; 

--  SELF\lfcRelationship1  toN.RelatedObjects  :  LIST  [1:?]  OF  IfcBuilding; 
ENDJENTITY; 

ENTITY  IfcRelVoidsElements 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELF\lfcRelationship1  toN.RelatingObject :  IfcElement; 

-  SELF\lfcRelationship1  toN.RelatedObjects  :  LIST  [1:?]  OF  IfcOpeningElement; 
WHERE 

WR1  :  NOT('IFC150FINAL. IFCOPENINGELEMENT'  IN 
TYPEOF(SELF\lfcRelationship1  toN.RelatingObject)); 

END_ENTITY; 

ENTITY  IfcSite 
SUBTYPE  OF  (IfcProduct); 

GenericType  :  IfcSiteTypeEnum; 

RefLatitude  :  IfcCompoundPlaneAngleMeasure; 

RefLongitude  :  IfcCompoundPlaneAngleMeasure; 

RefElevation  :  IfcLengthMeasure; 
calcSitePerimeter :  OPTIONAL  IfcPositiveLengthMeasure; 
calcSiteArea  :  OPTIONAL  IfcAreaMeasure; 

INVERSE 

Contains  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatingObject; 

IsContainedBy  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatedObjects; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

Temp.RelationshipType  =  ProjectContainer))  =  1; 

END_ENTITY; 

ENTITY  IfcSpace 
SUBTYPE  OF  (IfcSpatialElement); 

GenericType  :  IfcSpaceTypeEnum; 

BoundedBy  :  LIST  [1 :?]  OF  IfcSpaceBoundary; 

calcTotalPerimeter :  OPTIONAL  IfcPositiveLengthMeasure; 
calcTotalArea  :  OPTIONAL  IfcAreaMeasure; 
calcTotalVolume  :  OPTIONAL  IfcVolumeMeasure; 
calcAverageHeight  :  OPTIONAL  IfcPositiveLengthMeasure; 

INVERSE 

IsAssemblyThrough  :  SET  [0:1]  OF  IfcRelAssemblesSpaces  FOR  RelatingObject; 
PartOfAssembly  :  SET  [0:1]  OF  IfcRelAssemblesSpaces  FOR  RelatedObjects; 
Contains  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatingObject; 

IsContainedBy  :  SET  [0:?]  OF  IfcRelContains  FOR  RelatedObjects; 

WHERE 

WR1:  SIZEOF(QUERY(  temp  <*  SELFUfcObject.TypeDefinitions  | 
NOT(temp.TypedClass  =  'IfcSpace')))  =  0; 

WR2:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

Temp.RelationshipType  =  ProjectContainer))  =  1; 

WR3:  SIZEOF(QUERY(Temp  <*  IsContainedBy  | 

(((Temp.RelationshipType  =  SiteContainer) 

OR  (Temp.RelationshipType  =  BuildingStoreyContainer)) 

AND  (Temp.ContainedOrReferenced  =  TRUE ))))  =  1; 

ENDJENTITY; 

ENTITY  IfcSpaceBoundary 
SUBTYPE  OF  (IfcSpatialElement); 

PhysicalOrVirtual :  BOOLEAN; 

INVERSE 

Bounds  :  SET[1 :2]  OF  IfcSpace  FOR  BoundedBy; 

ProvidedBy  :  SET[0:1]  OF  IfcRelSeparatesSpaces 
FOR  RelatedObjects; 

WHERE 

WR1:  ((PhysicalOrVirtual  =  TRUE)  AND  (HIINDEX(ProvidedBy)  =  1)) 

OR 

((PhysicalOrVirtual  =  FALSE)  AND  (HIINDEX(ProvidedBy)  =  0)); 

END_ENTITY; 

ENTITY  IfcSpatialElement 
ABSTRACT  SUPERTYPE  OF  (ONEOF( 

IfcSpace 
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.IfcSpaceBoundary)) 

SUBTYPE  OF  (IfcProduct); 

END_ENTITY; 

ENTITY  IfcSystem 
SUBTYPE  OF  (IfcGroup); 

GenericType  :  IfcSystemTypeEnum; 

INVERSE 

ServicesBuildings  :  IfcRelServicesBuildings  FOR  RelatingObject; 

WHERE 

WR1:  SIZEOF(QUERY(  temp  <*  SELFMfcObject.TypeDefinitions  | 
NOT(temp.TypedClass  =  'IfcSystem')))  =  0; 

END_ENTITY; 

ENTITY  IfcZone 
SUBTYPE  OF  (IfcGroup); 

GenericType :  IfcZoneTypeEnum; 

WHERE 

WR1:  SIZEOF  (QUERY  (temp  <*  SELF\lfcGroup.GroupedBy.RelatedObjects  | 
('IFC150FINAL. IFCZONE'  IN  TYPEOF(temp))  OR 
('IFC150FINAL.IFCSPACE'  IN  TYPEOF(temp)) 

))  =  HIINDEX(SELF\lfcGroup.GroupedBy.RelatedObjects); 

WR2:  SIZEOF(QUERY(  temp  <*  SELF\lfcObject.TypeDefinitions  | 
NOT(temp.TypedClass  =  'IfcZone')))  =  0; 

END_ENTITY; 

--  IfcProductExtension  -  Function  Definitions 
FUNCTION  IfcNoOfLayers  ( 

Element :  IfcElement ) 

:  INTEGER; 

IF  NOT(EXISTS(Element.HasMaterial))  THEN 
RETURN  (?); 

ENDJF; 

IF  'IFC150FINAL.IFCMATERIAL'  IN  TYPEOF(Element.HasMaterial)  THEN 
RETURN  (1); 

ENDJF; 

IF  'IFC150FINAL.IFCMATERIALLAYERSET'  IN  TYPEOF(Element.HasMaterial)  THEN 
RETURN  (HIINDEX(Element.HasMaterial.HasMaterialLayers)); 

ENDJF; 

RETURN  (?); 

END_FUNCTION; 

--  IfcPropertyResource  -  Type  Specification  for  Actor 
TYPE  IfcRoleTypeEnum  =  ENUMERATION  OF  ( 

Supplier 

.Manufacturer 

.Contractor 

.Subcontractor 

.Architect 

.StructuralEngineer 

.ServicesEngineer 

.CostEngineer 

.Client 

.BuildingOwner 

.BuildingOperator 

.Other); 

END_TYPE; 

TYPE  IfcActorSelect  =  SELECT  ( 

IfcOrganization 
.  IfcPerson 

.IfcPersonAndOrganization); 

END_TYPE; 

-  IfcPropertyResource  -  Type  Specification  for  Material 
TYPE  IfcMaterialSelect  =  SELECT  ( 

IfcMaterialLayerSet 
,  IfcMaterialList); 

END_TYPE; 

--  IfcPropertyResource  -  Type  Specification  for  Cost 
TYPE  IfcCostOperatorEnum  =  ENUMERATION  OF  ( 

AddValue 

.SubstractValue 

.MultiplyValue 
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.AddPercent 

,SubstractPercent 

.MultiplyPercent); 

END_TYPE; 

TYPE  IfcCostTypeEnum  =  ENUMERATION  OF  ( 

LaborCost 

.PlantCost 

.MaterialCost 

,SubContractCost 

.PreliminariesCost 

.PrimeCost 

.BillOfMaterialsCost 

.ProvisionalCost); 

END_TYPE; 

TYPE  IfcCurrencyTypeEnum  =  ENUMERATION  OF  ( 

AED,  AES,  ATS,  AUD,  BBD,  BEG,  BGL,  BHD,  BMD, 

BND,  BRL,  BSD,  BWP,  BZD,  CAD,  CBD,  CHF,  CLP, 

CNY,  CYS,  CZK,  DDP,  DEM,  DKK,  EGL,  EST,  FAK, 

FIM,  FJD,  FKP,  FRF,  GBP,  GIP,  GMD,  GRX,  HKD, 
HUF,  ICK,  IDR,  ILS,  INR,  IRP,  ITL,  JMD,  JOD, 

JPY,  KES,  KRW,  KWD,  KYD,  LKR,  LUF,  MTL,  MUR, 
MXN,  MYR,  NLG,  NZD,  OMR,  PGK,  PHP,  PKR,  PLN, 
PTN,  QAR,  RUR,  SAR,  SCR,  SEK,  SGD,  SKP,  THB, 

TRL,  TTD,  TWD,  USD,  VEB,  VND,  XEU,  ZAR,  ZWD); 

END_TYPE; 

TYPE  IfcModifierBasisEnum  =  ENUMERATION  OF  ( 

Running 

.Static); 

END_TYPE; 

-  IfcPropertyResource  -  Type  Specification  for  DateTime 
TYPE  IfcDaylnMonthNumber  =  INTEGER; 

END_TYPE; 

TYPE  IfcDaylightSavingNumber  =  INTEGER; 

WHERE 

WR1:  { 0  <=  SELF  <=  2 }; 

END_TYPE; 

TYPE  IfcHourlnDay  =  INTEGER; 

WHERE 

WR1:  { 0  <=  SELF  <  24 }; 

END_TYPE; 

TYPE  IfcMinutelnHour  =  INTEGER; 

WHERE 

WR1:  {0  <=  SELF  <=  59 }; 

END_TYPE; 

TYPE  lfcMonthlnYearNumber=  INTEGER; 

WHERE 

WR1:  { 1<=  SELF  <=  12 }; 

END_TYPE; 

TYPE  IfcSecondlnMinute  =  REAL; 

WHERE 

WR1:  { 0  <=  SELF  <  60 }; 

END_TYPE; 

TYPE  IfcYearNumber  =  INTEGER; 

END_TYPE; 

TYPE  IfcDateTimeSelect  =  SELECT  ( 

IfcCalendarDate 
.IfcLocalTime 
JfcDateAndTime ); 

END_TYPE; 

--  IfcTypeDefResource  -  Entity  Definitions  for  Actor 
ENTITY  IfcActorRole; 

Name  :  IfcRoleTypeEnum; 

Description  :  OPTIONAL  STRING; 

END_ENTITY; 

ENTITY  IfcAddress; 

InternalLocation  :  OPTIONAL  STRING; 

AddressLines  :  LIST  [0:?]  OF  STRING; 

Town  :  OPTIONAL  STRING; 
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Region  :  OPTIONAL  STRING; 

PostalCode  :  OPTIONAL  STRING; 

Country  :  OPTIONAL  STRING; 

FacsimileNumbers  :  LIST  [0:?]  OF  STRING; 

TelephoneNumbers  :  LIST  [0:?]  OF  STRING; 

ElectronicMailAddresses  :  LIST  [0:?]  OF  STRING; 

TelexNumber  :  OPTIONAL  STRING; 

WWWHomePage  :  OPTIONAL  STRING; 

Description  :  OPTIONAL  STRING; 

INVERSE 

OfPerson  :  SET[0:?]  OF  IfcPerson  FOR  Addresses; 

OfOrganization  :  SET[0:?]  OF  IfcOrganization  FOR  Adresses; 

WHERE 

WR1:  EXISTS  (InternalLocation)  OR 
(HIINDEX(AddressLines)  >  0)  OR 
EXISTS  (Town)  OR 
EXISTS  (Region)  OR 
EXISTS  (PostalCode)  OR 
EXISTS  (Country)  OR 
(HIINDEX(FacsimileNumbers)  >  0)  OR 
(HIINDEX(TelephoneNumbers)  >  0)  OR 
(HIINDEX(ElectronicMailAddresses)  >  0)  OR 
EXISTS  (WWWHomePage); 

END_ENTITY; 

ENTITY  IfcOrganization 
SUBTYPE  OF  (IfcProperty); 

Name  :  STRING; 

Adresses  :  LIST  [0:?]  OF  IfcAddress; 

Roles  :  LIST  [0:?]  OF  IfcActorRole; 

Description  :  OPTIONAL  STRING; 

END_ENTITY; 

ENTITY  IfcPerson 
SUBTYPE  OF  (IfcProperty); 

FamilyName  :  OPTIONAL  STRING; 

GivenName  :  OPTIONAL  STRING; 

MiddleNames  :  OPTIONAL  STRING; 

PrefixTitles  :  OPTIONAL  STRING; 

SuffixTitles :  OPTIONAL  STRING; 

Addresses  :  LIST  [0:?]  OF  IfcAddress; 

Roles  :  LIST  [0:?]  OF  IfcActorRole; 

WHERE 

WR1:  EXISTS(FamilyName)  OR  EXISTS(GivenName); 

END_ENTITY; 

ENTITY  IfcPersonAndOrganization 
SUBTYPE  OF  (IfcProperty); 

ThePerson  :  IfcPerson; 

TheOrganization :  IfcOrganization; 

Roles  :  LIST  [0:?]  OF  IfcActorRole; 

END_ENTITY; 

--  IfcPropertyResource  -  ENTITY  Definitions  for  Material 
ENTITY  Material 
SUBTYPE  OF  (IfcProperty); 

MaterialName  :  STRING; 

MaterialClassification :  IfcClassificationList; 

INVERSE 

RegisteredBy  :  IfcProjectMaterialRegistry  FOR  RegisteredMaterials; 
END  jENTITY; 

ENTITY  IfcMaterialList 
SUBTYPE  OF  (IfcProperty); 

Materials  :  Material; 

END_ENTITY; 

ENTITY  IfcMaterial Layer; 

Material  :  IfcMaterial; 

OffsetFromMLSBase  :  IfcPositiveLengthMeasure; 

LayerThickness  :  IfcPositiveLengthMeasure; 

DefaultPriority  :  INTEGER; 

END_ENTITY; 

ENTITY  IfcMaterial LayerSet 
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SUBTYPE  OF  (IfcProperty); 

LayerSetName  :  STRING; 

HasMaterialLayers  :  LIST  [1 :?]  OF  IfcMaterialLayer; 
END_ENTITY; 

ENTITY  IfcMaterialLayerSetUsage; 

ForLayerSet  :  IfcMaterialLayerSet; 
MIsOffsetFromBaseline:  IfcLengthMeasure; 
MIsSenseLtoR  :  BOOLEAN; 

DERIVE 

TotalThickness  :  IfcLengthMeasure 

:=  IfcMlsTotalThickness(ForLayerSet); 

END_ENTITY; 

ENTITY  IfcProjectMaterialRegistry; 

RegisteredMaterials  :  LIST  [0:?]  OF  IfcMaterial; 
ENDJENTITY; 

--  IfcPropertyResource  -  Entity  Definitions  for  Classification 
ENTITY  IfcClassification 
SUBTYPE  OF  (IfcProperty); 

Source  :  STRING; 

Table  :  OPTIONAL  STRING; 

Notation  :  IfcClassificationNotation; 

Description  :  STRING; 

Edition  :  OPTIONAL  STRING; 

ENDJENTITY; 

ENTITY  IfcClassificationList 
SUBTYPE  OF  (IfcProperty); 

Classifications  :  LIST  [1:?]  OF  IfcClassification; 

Priority  :  INTEGER; 

END_ENTITY; 

ENTITY  IfcClassificationNotation; 

NotationStrings:  LIST  [1:?]  OF  IfcNotationString; 
END_ENTITY; 

ENTITY  IfcNotationString; 

NotationValue  :  STRING; 

Separator  :  OPTIONAL  STRING; 

Purpose  :  OPTIONAL  STRING; 

ENDJENTITY; 

--  IfcPropertyResource  -  Entity  Definitions  for  Cost 
ENTITY  IfcCost 
SUBTYPE  OF  (IfcProperty); 

CostType  :  IfcCostTypeEnum; 

BaseCostValue  :  OPTIONAL  REAL; 

FinalCostValue  :  OPTIONAL  REAL; 

Currency  :  IfcCurrencyTypeEnum; 

ModifierBasis  :  OPTIONAL  IfcModifierBasisEnum; 
CostModifiers  :  LIST[0:?]  OF  IfcCostModifier; 
UnitCostBasis  :  IfcMeasureWithUnit; 

CostDate  :  OPTIONAL  IfcDateTimeSelect; 

CostComponents  :  LIST  [0:?]  OF  IfcCost; 

ENDJENTITY; 

ENTITY  IfcCostModifier; 

Purpose  :  STRING; 

CostValue  :  REAL; 

CostOperator  :  IfcCostOperatorEnum; 

END_ENTITY; 

--  IfcPropertyResource  -  Entity  Definition  for  Date  and  Time 
ENTITY  IfcCalendarDate 
SUBTYPE  OF  (IfcProperty); 

DayComponent  :  IfcDaylnMonthNumber; 
MonthComponent  :  IfcMonthlnYearNumber; 
YearComponent  :  IfcYearNumber; 

WHERE 

WR1:  IfcValidCalendarDate  (SELF); 

END_ENTITY; 

ENTITY  IfcCoordinatedUniversalTimeOffset; 

HourOffset  :  IfcHourlnDay; 

MinuteOffset  :  OPTIONAL  IfcMinutelnHour; 

Ahead  :  BOOLEAN; 
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ENDJENTITY; 

ENTITY  IfcDateAndTime 
SUBTYPE  OF  (IfcProperty); 

DateComponent  :  IfcCalendarDate; 

TimeComponent  :  IfcLocalTime; 

END_ENTITY; 

ENTITY  IfcLocalTime 
SUBTYPE  OF  (IfcProperty); 

FlourComponent  :  IfcHourlnDay; 

MinuteComponent :  OPTIONAL  IfcMinutelnHour; 

SecondComponent :  OPTIONAL  IfcSecondlnMinute; 

Zone  :  IfcCoordinatedUniversalTimeOffset; 
DaylightSavingOffset :  OPTIONAL  IfcDaylightSavingNumber; 
WHERE 

WR1:  IfcValidTime  (SELF); 

END_ENTITY; 

--  IfcPropertyResource  -  Function  Definition  for  Material 
FUNCTION  IfcM IsT otalThickn ess  ( 

LayerSet :  IfcMaterialLayerSet) 

:  IfcLengthMeasure; 

LOCAL 

Max :  IfcLengthMeasure 

:=  LayerSet.HasMaterialLayers[1].OffsetFromMLSBase 
+  LayerSet.HasMaterialLayers[1].LayerThickness; 

Min :  IfcLengthMeasure 

:=  LayerSet.HasMaterialLayers[1].OffsetFromMLSBase; 
END_LOCAL; 

IF  SIZEOF(LayerSet.HasMaterialLayers)  >  1  THEN 
REPEAT  i  :=  2  TO  Hilndex(LayerSet.HasMaterialLayers); 

IF  (LayerSet.HasMaterialLayers[i].OffsetFromMLSBase 
+  LayerSet.HasMaterialLayers[i].LayerThickness)  >  Max 
THEN  Max  :=  LayerSet.HasMaterialLayers[i].OffsetFromMLSBase 
+  LayerSet.HasMaterialLayers[i].LayerThickness; 

ENDJF; 

IF  LayerSet.HasMaterialLayers[i].OffsetFromMLSBase  <  Min 
THEN  Min  :=  LayerSet.HasMaterialLayers[i].OffsetFromMLSBase; 
ENDJF; 

ENDJREPEAT; 

ENDJF; 

RETURN  (Max -Min); 

END_FUNCTION; 

-  IfcPropertyResource  -  Function  Definition  for  Date  and  Time 
FUNCTION  IfcLeapYear  ( 

Year :  IfcYearNumber) 

:  BOOLEAN; 

IF  ((((Year  MOD  4)  =  0)  AND  ((Year  MOD  100)  <>  0))  OR 
((Year  MOD  400)  =  0))  THEN 
RETURN(TRUE); 

ELSE 

RETURN(FALSE); 

ENDJF; 

END_FUNCTION; 

FUNCTION  IfcValidCalendarDate  ( 

Date :  IfcCalendarDate) 

:  LOGICAL; 

IF  NOT  ({1  <=  Date.DayComponent  <=  31})  THEN 
RETURN(FALSE); 

ENDJF; 

CASE  Date.MonthComponent  OF 
4  :  RETURN({  1<=  Date.DayComponent  <=  30}); 

6  :  RETURN({  1<=  Date.DayComponent  <=  30}); 

9  :  RETURN({  1<=  Date.DayComponent  <=  30}); 

1 1  :  RETURN({  1<=  Date.DayComponent  <=  30}); 

2  : 

BEGIN 

IF  (IfcLeapYear(Date.YearComponent))  THEN 
RETURN({  1<=  Date.DayComponent  <=  29}); 

ELSE 
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RETURN({  1<=  Date.DayComponent  <=  28}); 

ENDJF; 

END; 

OTHERWISE  :  RETURN(TRUE); 

END_CASE; 

END_FUNCTION; 

FUNCTION  IfcValidTime  (Time:  IfcLocalTime) :  BOOLEAN; 

IF  EXISTS  (Time.SecondComponent)  THEN 
RETURN  (EXISTS  (Time.MinuteComponent)); 

ELSE 

RETURN  (TRUE); 

ENDJF; 

END_FUNCTION; 

--  Entity  Definitions  for  Type  Def  and  Property  Set 
TYPE  IfcTypeDefDomainViewEnum  =  ENUMERATION  OF  ( 

CrossDomain 

Architecture 

,HVAC 

.FacMgmt); 

END_TYPE; 

--  Entity  Definitions  for  Type  Def  and  Property  Set 
ENTITY  IfcObjectReference 
SUBTYPE  OF  (IfcProperty); 

Descriptor  :  STRING; 

ObjectReference  :  IfcProjectUniqueld; 

ENDJENTITY; 

ENTITY  IfcOccurrencePropertySet 
SUBTYPE  OF  (IfcPropertySet); 

TypeReference  :  IfcPropertyT ypeDef ; 

WHERE 

WR1:  SIZEOF(QUERY(temp  <*  SELF\lfcPropertySet.HasProperties  | 

'IFC150FINAL.IFCPRODUCTSHAPE'  IN  TYPEOF(temp)))  =  0; 

ENDJENTITY; 

ENTITY  IfcProperty 

ABSTRACT  SUPERTYPE  OF  (ONEOF 

(IfcPropertySet,  IfcObjectReference,  lfcSimpleProperty,lfcProductShape,lfcCalendarDate,lfcClassification,lfcClassificationList,lfcCost,  If 
cDateAndTime,  IfcLocalTime,  lfcMaterial,lfcMaterialLayerSet,lfcMaterialList,lfcOrganization,lfcPerson,lfcPersonAndOrganization)); 
INVERSE 

PartOfPropertySet  :  SET  [0:1]  OF  IfcPropertySet 
FOR  HasProperties; 

END_ENTITY; 

ENTITY  IfcPropertySet 
SUPERTYPE  OF  (ONEOF( 

IfcSharedPropertySet 

IfcOccurrencePropertySet)) 

SUBTYPE  OF  (IfcProperty); 

Projectld  :  IfcProjectUniqueld; 

Descriptor  :  STRING; 

HasProperties  :  LIST  [1:?]  OF  IfcProperty; 

WHERE 

WR1:  SIZEOF(QUERY(Temp  <*  HasProperties  |  Temp  :=:  SELF))  =  0; 

END_ENTITY; 

ENTITY  IfcP ropertyT ype Def ; 

Projectld  :  IfcProjectUniqueld; 

OwnerHistory  :  IfcOwnerHistory; 

TypeDefName  :  STRING; 

TypedClass  :  STRING; 

GenericType  :  OPTIONAL  STRING; 

SpecificType  :  OPTIONAL  STRING; 

TypeDomainView  :  IfcTypeDefDomainViewEnum; 

SharedProperties  :  LIST  [0:?]  OF  IfcSharedPropertySet; 

GenericTypeReference  :  OPTIONAL  IfcPropertyTypeDef; 

INVERSE 

ReferencedBySpecificType  :  SET  [0:?]  OF  IfcPropertyTypeDef 
FOR  GenericTypeReference; 

OccurrenceSets  :  SET  [0:?]  OF  IfcOccurrencePropertySet 
FOR  TypeReference; 


WHERE 
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WR1:  EXISTS(GenericType)  OR  EXISTS(SpecificType); 
END_ENTITY; 

ENTITY  IfcPropertyWithUnit 
SUBTYPE  OF  (IfcSimpleProperty); 

UnitComponent  :  IfcUnit; 

END_ENTITY; 

ENTITY  IfcSharedPropertySet 
SUBTYPE  OF  (IfcPropertySet); 

INVERSE 

TypeDefined  :  IfcPropertyTypeDef 
FOR  SharedProperties; 

WHERE 

WR1:  SIZEOF(QUERY(temp  <*  SELFMfcPropertySet.HasProperties  | 
'IFC150FINAL.IFCPRODUCTSHAPE'  IN  TYPEOF(temp)))  =  0; 
END_ENTITY; 

ENTITY  IfcSimpleProperty 

SUPERTYPE  OF  (ONEOF(lfcPropertyWithUnit)) 

SUBTYPE  OF  (IfcProperty); 

Descriptor  :  STRING; 

ValueComponent  :  IfcMeasureValue; 

ENDJENTITY; 

--  Type  Definitions  for  Shape  Representation 
TYPE  IfcRepDetailTypeEnum  =  ENUMERATION  OF  ( 

Sketch 

.Outline 

.Design 

.Detail 

.Undefined); 

ENDJYPE; 

TYPE  IfcRepViewT ypeEnu m  =  ENUMERATION  OF  ( 

Plan 

.Section 

.Elevation 

.Isometric 

.Diagrammatic 

.Undefined); 

END_TYPE; 

TYPE  IfcShapeRepTypeEnum  =  ENUMERATION  OF  ( 

BoundingBox 

.AttributeDriven 

.Explicit); 

END_TYPE; 

TYPE  IfcBooleanOperator  =  ENUMERATION  OF  ( 

Union 

.Difference 

.Intersection); 

END_TYPE; 

TYPE  IfcProductComponentShapeSelect  =  SELECT  ( 

IfcShapeBody 

.IfcShapeResult); 

END_TYPE; 

--  Entity  Definitions  for  Shape  Representation 
ENTITY  IfcProductShape 
SUBTYPE  OF  (IfcProperty); 

Projectld  :  IfcProjectUniqueld; 

ProductComponentShape  :  IfcProductComponentShapeSelect; 
Descriptor  :  OPTIONAL  STRING; 

ENDJENTITY; 

ENTITY  IfcRepresentationContext; 

Projectld  :  IfcProjectUniqueld; 

DetailType  :  IfcRepDetailTypeEnum; 

ViewType  :  IfcRepViewTypeEnum; 

Precision  :  INTEGER; 

INVERSE 

RepresentationsInContext :  SET[1 ;?]  OF  IfcShapeRepresentation 
FOR  ContextOfltems; 

END_ENTITY; 

ENTITY  IfcShapeBody; 
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Projectld  :  IfcProjectUniqueld; 

Representations  :  LIST  [1 :?]  OF  IfcShapeRepresentation; 

ComponentDescriptor:  OPTIONAL  STRING; 

END_ENTITY; 

ENTITY  IfcShapeResult; 

Projectld  :  IfcProjectUniqueld; 

Operands  :  LIST  [2:?]  OF  IfcProductComponentShapeSelect; 

Operator  :  IfcBooleanOperator; 

ComponentDescriptor:  OPTIONAL  STRING; 

WHERE 

WR1:  Operator  <>  IfcBooleanOperator.Intersection; 

END_ENTITY; 

ENTITY  IfcShapeRepresentation; 

Items  :  SET  [1 :?]  OF  IfcGeometricRepresentationltem; 

ContextOfltems  :  IfcRepresentationContext; 

RepresentationType :  IfcShapeRepTypeEnum; 

UsageDescriptor  :  OPTIONAL  STRING; 

INVERSE 

OfShapeBody  :  IfcShapeBody  FOR  Representations; 

WHERE 

WR1:  ((RepresentationType  =  BoundingBox)  AND  (HIINDEX(ltems)  =  1)  AND 
('IFC150FINAL.IFCBOUNDINGBOX'  IN  TYPEOF(ltems[1  ]))) 

OR 

((RepresentationType  =  AttributeDriven)  AND  (HIINDEX(ltems)  =  1)  AND 
(('IFC150FINAL.IFCATTDRIVENEXTRUDEDSOLID'  IN  TYPEOF(ltems[1  ])) 

OR  ('IFC150FINAL.IFCATTDRIVENREVOLVEDSOLID'  IN  TYPEOF(ltems[1  ])))) 
OR 

((RepresentationType  =  Explicit)  AND  (SIZEOF(QUERY(temp  <*  Items  | 
('IFC150FINAL.IFCBOUNDINGBOX'  IN  TYPEOF(temp)) 

OR  ('IFC150FINAL.IFCATTDRIVENEXTRUDEDSOLID'  IN  TYPEOF(temp)) 

OR  ('IFC150FINAL.IFCATTDRIVENREVOLVEDSOLID'  IN  TYPEOF(temp))))  =  0)); 
END_ENTITY; 

--  IfcSharedBldgElements  -  Type  Definitions 
TYPE  IfcBeamTypeEnum  =  ENUMERATION  OF  ( 

SimpleBeam 

,CompoundBeam 

.Truss); 

END_TYPE; 

TYPE  IfcBuiltlnTypeEnum  =  ENUMERATION  OF  ( 

Cabinet 

.CounterTop 

.Railing); 

END_TYPE; 

TYPE  IfcColumnTypeEnum  =  ENUMERATION  OF  ( 

SimpleColumn 

.CompoundColumn 

.Truss); 

END_TYPE; 

TYPE  IfcCoveringTypeEnum  =  ENUMERATION  OF  ( 

Ceiling 

.Flooring 

.Wallcovering); 

END_TYPE; 

TYPE  IfcDoorTypeEnum  =  ENUMERATION  OF  ( 

SingleSwing 

.DoubleSwing 

.Slide 

.Rollup 

.Revolving); 

ENDJTPE; 

TYPE  IfcFloorTypeEnum  =  ENUMERATION  OF  ( 

SolidFloor 

.LayeredFloor 

.ElementedFloor); 

END_TYPE; 

TYPE  IfcRoofSIabTypeEnum  =  ENUMERATION  OF  ( 

SolidSlab 

.LayeredSlab 
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.ElementedSlab); 

END_TYPE; 

TYPE  IfcWallTypeEnum  =  ENUMERATION  OF  ( 

SolidWall 

.LayeredWall 

.ElementedWall); 

END_TYPE; 

TYPE  IfcWindowTypeEnum  =  ENUMERATION  OF  ( 

FixedCasement 

.Sliding 

.Awning 

.DoupleHung 

.Casement 

.Pivoting); 

END_TYPE; 

--  IfcSharedBldgElements  -  Entity  Definitions 
ENTITY  IfcBeam 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType :  IfcBeamTypeEnum; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcBeam')))  =  0; 

WR2:  'IFC150FINAL.IFCMATERIAL'  IN  TYPEOF(SELF\lfcBuildingElement.HasMaterial); 
END_ENTITY; 

ENTITY  IfcBuiltln 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType :  IfcBuiltlnTypeEnum; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcBuiltln')))  =  0; 

END_ENTITY; 

ENTITY  IfcColumn 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType :  IfcColumnTypeEnum; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcColumn')))  =  0; 

WR2:  'IFC150FINAL.IFCMATERIAL'  IN  TYPEOF(SELRIfcBuildingElement.HasMaterial); 
ENDJENTITY; 

ENTITY  IfcCovering 
SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcCoveringTypeEnum; 

Layerlnformation  :  IfcMaterialLayerSetUsage; 

DERIVE 

SELRIfcBuildingElement.HasMaterial :  IfcMaterialSelect 
:=  Layerlnformation. ForLayerSet; 

INVERSE 

Covers  :  IfcRelCoversBIdgElements  FOR  RelatedObjects; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOTfTemp.TypedClass  =  'IfcCovering')))  =  0; 

WR2:  'IFC150FINAL.IFCMATERIALLAYERSET'  IN 
TYPEOF(SELF\lfcBuildingElement.HasMaterial); 

END_ENTITY; 

ENTITY  IfcDoor 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcDoorTypeEnum; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOTfTemp.TypedClass  =  'IfcDoor')))  =  0; 

END_ENTITY; 

ENTITY  IfcFloor 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcFloorTypeEnum; 

Layerlnformation  :  IfcMaterialLayerSetUsage; 

DERIVE 

SELFMfcBuildingElement.HasMaterial :  IfcMaterialSelect 
:=  Layerlnformation. ForLayerSet; 
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WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcFloor')))  =  0; 

WR2:  'IFC150FINAL.IFCMATERIALLAYERSET'  IN 
TYPEOF(SELF\lfcBuildingElement.HasMaterial); 

END_ENTITY; 

ENTITY  IfcRelCoversBIdgElements 
SUBTYPE  OF  (IfcRelationshipItoN); 

--  SELF\lfcRelationship1  toN.RelatingObject :  IfcBuildingElement; 

--  SELF\lfcRelationship1  toN.RelatedObjects  :  LIST  [1:?]  OF  IfcCovering; 
END_ENTITY; 

ENTITY  IfcRoofSIab 
SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcRoofSIabTypeEnum; 

Layerlnformation  :  IfcMaterialLayerSetUsage; 

DERIVE 

SELF\lfcBuildingElement.HasMaterial :  IfcMaterialSelect 
:=  Layerlnformation. ForLayerSet; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcRoofSIab')))  =  0; 

WR2:  'IFC150FINAL.IFCMATERIALLAYERSET'  IN 
TYPEOF(SELF\lfcBuildingElement.HasMaterial); 

END_ENTITY; 

ENTITY  IfcWall 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcWallTypeEnum; 

Layerlnformation  :  IfcMaterialLayerSetUsage; 

DERIVE 

SELFMfcBuildingElement.HasMaterial :  IfcMaterialSelect 
:=  Layerlnformation. ForLayerSet; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcWall')))  =  0; 

WR2:  'IFC150FINAL.IFCMATERIALLAYERSET'  IN 
TYPEOF(SELRIfcBuildingElement.HasMaterial); 

END_ENTITY; 

ENTITY  IfcWindow 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcWindowTypeEnum; 

WHERE 

WR1:  SIZEOF(QUERY(  Temp  <*  SELRIfcObject.TypeDefinitions  | 
NOT(Temp.TypedClass  =  'IfcWindow')))  =  0; 

END_ENTITY; 

--  IfcSharedBldgElements  -  Type  Definitions 

TYPE  IfcElectricalApplianceTypeEnum  =  ENUMERATION  OF  ( 

Computer 
, Copier 
.Facsimile 
.Printer 
.Telephone); 

END_TYPE; 

TYPE  IfcEquipmentTypeEnum  =  ENUMERATION  OF  ( 

AirFilter 

.AirHandler 

.Boiler 

.Chiller 

.Coil 

.Compressor 

.Convector 

.CoolingTower 

.Fan 

.HeatExchanger 

.Motor 

.PackagedACUnit 

.Pump 

.TubeBundle 

.UnitHeater); 
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END_TYPE; 

TYPE  [fcFixtureTypeEnum  =  ENUMERATION  OF  ( 

Electrical 

.Plumbing); 

END_TYPE; 

TYPE  IfcDiscreteElementTypeEnum  =  ENUMERATION  OF  ( 

Insulation); 

END_TYPE; 

TYPE  IfcDistributionElementTypeEnum  =  ENUMERATION  OF  ( 
NotYetDefined); 

END_TYPE; 

--  IfcSharedBldgServiceElements  -  Entity  Definitions 
ENTITY  IfcElectricalAppliance 
SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcElectricalApplianceTypeEnum; 

ENDJENTITY; 

ENTITY  IfcEquipment 
SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcEquipmentTypeEnum; 

ENDJENTITY; 

ENTITY  IfcFixture 

SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcFixtureTypeEnum; 

END_ENTITY; 

ENTITY  IfcDiscreteElement 
SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcDiscreteElementTypeEnum; 

END_ENTITY; 

ENTITY  IfcDistributionElement 
SUBTYPE  OF  (IfcBuildingElement); 

GenericType  :  IfcDistributionElementTypeEnum; 

END_ENTITY; 

--  IfcUtilityResource  -  Type  Definitions 
TYPE  IfcGloballyUniqueld  =  STRING; 

END_TYPE; 

TYPE  IfcProjectUniqueld  =  STRING; 

END_TYPE; 

--  IfcUtilityResource  -  Entity  Definitions 
ENTITY  IfcAuditTrail; 

CreationDate  :  IfcTimeStamp; 

DeletionDate  :  OPTIONAL  IfcTimeStamp; 

CreatingUser  :  INTEGER; 

DeletingUser  :  OPTIONAL  INTEGER; 

CreatingApplication  :  INTEGER; 

DeletingApplication  :  OPTIONAL  INTEGER; 

AuditTrailLength  :  INTEGER; 

Transactions  :  LIST  [0:AuditT railLength]  OF  IfcT ransaction; 
INVERSE 

ToOwnerFlistory  :  IfcOwnerFHistory  FOR  AuditTrail; 

WHERE 

WR1:  AuditTrailLength  <=  1; 

END_ENTITY; 

ENTITY  IfcOwnerHistory; 

OwningActor  :  INTEGER; 

OwningApplication  :  INTEGER; 

Applicationld  :  OPTIONAL  STRING; 

OwnerDescriptor  :  OPTIONAL  STRING; 

AuditTrail  :  OPTIONAL  IfcAuditTrail; 

END_ENTITY; 

ENTITY  IfcProjectAppRegistry; 

RegisteredApps  :  LIST  [0:?]  OF  UNIQUE  IfcRegisteredApplication; 
ENDJENTITY; 

ENTITY  IfcProjectTeamRegistry; 

RegisteredActors  :  LIST  [0:?]  OF  UNIQUE  IfcActorSelect; 
ENDJENTITY; 

ENTITY  IfcRegisteredApplication; 

Applicationldentifier:  STRING(16); 

ApplicationFullName  :  STRING(255); 
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ApplicationDeveloper :  IfcActorSelect; 

INVERSE 

RegisteredBy  :  IfcProjectAppRegistry  FOR  RegisteredApps; 
ENDJENTITY; 

ENTITY  IfcTransaction; 

TransactionDate  :  IfcTimeStamp; 

TransactingUser  :  INTEGER; 

TransactingApplication  :  INTEGER; 

INVERSE 

ToAuditTrail  :  IfcAuditTrail  FOR  Transactions; 

END_ENTITY; 

ENTITY  IfcTable; 

Projectld  :  IfcProjectUniqueld; 

Name  :  STRING; 

Rows  :  LIST  [1 :?]  OF  IfcTableRow; 

DERIVE 

NumberOfCellsinRow  :  INTEGER 

:=  HIINDEX(Rows[1].RowCells); 

NumberOfHeadings  :  INTEGER 

:=  SIZEOF(QUERY(  Temp  <*  Rows  |  Temp.lsHeading)); 
NumberOfDataRows  :  INTEGER 

:=  SIZEOF(QUERY(  Temp  <*  Rows  |  NOT(Temp.lsHeading))); 

WHERE 

WR2:  SIZEOF(QUERY(  Temp  <*  Rows  | 

HIINDEX(Temp.RowCells)  <>  H I INDEX(Rows[1  ] . RowCells))) 

=  0; 

WR3:  { 0  <=  NumberOfHeadings  <=  1  }; 

END_ENTITY; 

ENTITY  IfcTableRow; 

RowCells  :  LIST  [1 :?]  OF  IfcMeasureValue; 

IsHeading  :  BOOLEAN; 

INVERSE 

OfTable  :  IfcTable  FOR  Rows; 

ENDJENTITY; 

END_SCHEMA; 
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Appendix  B:  Modified  Generated  Files 

The  following  is  a  listing  of  the  automatically  generated  classes  that  were  modi¬ 
fied.  These  files  can  be  found  be  searching  for  the  string  “MDS  ADDED”  through 
all  Java  files. 

•  CIfcaxis2placement.java 

•  CIfcaxis2placement2d.java 

•  CIfcaxis2placement3d.java 

•  Clfcboundingbox.java 

•  Clfcbuil  ding,  java 

•  Clfcbuildingstorey.java 

•  Clfccartesianpoint.java 

•  Clfcdirection.java 

•  Clfcdoor.java 

•  Clfclocalplacement.java 

•  Clfcmeasurevalue.java 

•  Clfcproductshape.java 

•  Clfcproject.java 

•  Clfcpropertyset.java 

•  Clfcsharedpropertyset.java 

•  Clfcsimpleproperty.java 

•  Clfcsite.java 

•  Clfcspace.java 

•  Clfcwall.java 

•  Clfcwindow.java 
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Appendix  C:  Custom  Class  Code 

The  following  are  the  custom  classes  that  were  created. 


MDSAppInst 

public  interface  lnt_MDSApplnst  extends  SDAl.lang.AppJnst  { 

/**  Returns  string  of  guid  (global  unique  identifier).  7 
public  String  getGUID(); 

/**  Returns  string  of  version  ("versionMajor:versionMinor").  7 
public  String  getVersion(); 
public  long  getVersionMajor(); 
public  long  getVersionMinor(); 

/**  Returns  string  representation  of  the  object.  Created  as:<p> 

*  new  Stringer  +  getGUIDQ  +  ":Ver:”  +  getVersion()  + "]") 

*1 

public  String  toString(); 

/**  Dumps  object  representation  to  System.out.  7 
public  void  dump(); 

} 

public  abstract  class  MDSAppInst 

extends  SDAl.COM.steptools.CAppJnst 

implements  lnt_MDSApplnst,  lnt_MDSDumpTolFC,  Serializable  { 

private  long  m_versionMajor; 

private  long  m_versionMinor; 

private  boolean  m_checkedOut; 

protected  String  m_guid; 

protected  java.Iang.String  Projectid  =  null; 

II  count  used  in  creation  of  m_guid 
static  transient  private  long  count  =  0; 

II  boolean  used  during  write  to  IFC  file 
transient  private  boolean  dumpingTolFC  =  false; 

/** 

*  Default  constructor.  A  m_guid  is  created  during  construction  and  m_versionMajor  set  to  1 ,  m_versionMinor  set  to  0. 

7 

public  MDSApplnst()  { 
m_versionMajor  =  1; 
m_versionMinor  =  0; 
m_checkedOut  =  false; 

setGUID(generateGUID(classNameFinalPortion())); 
count  +=  1;  II  update  counter 

} 

/** 

*  Utility  to  return  the  final  portion  of  a  class  name.  If  full  class  name  is  'packagel  ,package2.classA',  this  will  return  'classA'. 
*1 

public  final  String  classNameFinalPortionQ  { 

II  get  final  portion  of  class  name  as  base  for  m_guid 

return  getClass().getName().substring(getClass().getName().lastlndexOf('.')  + 1); 

} 

/** 

*  Routine  to  generate  GUID.  GUID  is: 

*  base  +  ”_x_"  +  count  +  "_x_"  +  random  number 
7 

private  static  String  generateGUID(String  base)  { 

StringBuffer  tmp  =  new  StringBuffer(base); 

Random  rand  =  new  RandomQ; 

tmp.append(”_x"); 

tmp.append(count); 

tmp.append(”x_"); 

tmp.append(rand.nextLong()); 

return  tmp.toString(); 

} 
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/**  Will  remove  this  object  from  MDSObjectExtents  if  tracked.  7 
public  boolean  delete))  { 

System.out.println("MDSApplnst:delete: 11  +  this); 
if  (MDSObjectExtents.getlnstance()  !=  null)  { 

if  (MDSObjectExtents.getlnstance().findObject(this))  { 

MDSObjectExtents.getlnstance().removeObject(this); 

} 

} 

return  true; 

} 

public  boolean  checkout))  { 
m_checkedOut  =  true; 
return  true; 

} 

public  boolean  checkin))  { 
m_versionMinor++; 
if  (m_versionMinor  ==  100)  { 
m_versionMajor++; 
m_versionMinor  =  0; 

} 

m_checkedOut  =  true; 
return  true; 

} 

private  final  void  setGUID(String  guid)  { 
m_guid  =  guid; 

Projectid  =  guid; 

} 

public  final  String  getGUID))  { return  m_guid;} 
public  final  String  getVersion))  { 

return  new  String(String.valueOf(m_versionMajor)  + +  String.valueOf(m_versionMinor)); 

} 

public  final  long  getVersionMajor))  { return  m_versionMajor;} 
public  final  long  getVersionMinor))  { return  m_versionMinor;} 
public  void  dump))  { 

System  .out.  print)" '==  OBJECT  == "  +  classNameFinalPortion))  + ", "  +  toString))  +  "\n"); 

} 

public  String  toString))  { 

return  new  String)")"  +  getGUID))  +  ":Ver:"  +  getVersion))  + "]"); 

} 

//============================================================================== 

//============================================================================== 

II  routine  to  print  to  system.out  the  internal  field  values 
public  void  dumplntemals))  { 

processClasslnternals(true); 

} 

II  routine  to  retrieve  the  internal  field  values  as  a  vector  of  strings 
public  Vector  getlnternals))  { 

return  processClasslnternals(false); 

} 

private  Vector  processClasslnternals(boolean  display)  { 

Vector  internals  =  new  Vector)); 
try) 

Class  c  =  getClass)); 

if  (display  ==  true)  System  .out.  pri  ntl  n  ("  I  nsta  nee "  +  this); 
if  (display  ==  true)  System.out.printlnf'Class "  +  c); 
processFieldlnternals(internals,  display,  c,  this); 

Class  superC  =  c.getSuperclass)); 
while  (superC  !=  null)  { 

if  (display  ==  true)  System.out.printlnf'Superclass "  +  superC); 
if  (superC  ==  Class.forNamef'java.Iang.Object")) 
superC  =  null; 

else  if  (superC  ==  Class.forName("SDAI.COM.steptools.CApp_inst")) 
superC  =  null; 

else  { 

processFieldlnternals(internals,  display,  superC,  this); 
superC  =  superC.getSuperclass)); 

} 

} 

} 

catch  (Exception  exc)  { 

exc.printStackTrace)); 

} 

return  internals; 

} 

private  void  processFieldlnternals(Vector  internals,  boolean  display,  Class  c,  Object  inst)  { 

String  field; 
try) 
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FieldO  fields  =  c.getDeclaredFields(); 
for  (int  i  =  0;  i  <  fields.length;  i++)  { 

try  { 

Object  obj  =  fields[i].get(this); 

field  =  new  String(c.getName()  + +  fields[i].getName()  + "  +  obj); 

Snternals.addElement(field); 

if  (display  ==  true) 

System.out.println(c.getName()  + +  fields[i].getName()  + "  +  obj); 
if  (obj  !=  null)  { 

Class  cl  =  obj.getClass(); 
if  (obj.getClassQ.isArrayO)  { 
if  (display  ==  true) 

System .  out.  pri  ntl  n  ("\t"  +  obj.getClass().getComponentType().getName()  + 
"["  +  Array.getLength(obj)  +  “]"); 

} 

} 

} 

catch  (HlegalAccessException  exc)  { 

System.out.printlnjc  + "  HlegalAccessException,  ”  +  fields[i].getName()); 

} 

} 

} 

catch  (Exception  exc)  { 

exc.printStackTrace(); 

} 

} 

//=============================================================================================== 

//=============================================================================================== 

II  routine  to  dump  to  a  part  21  file  this  instance  and  any  attribute  object  variables 
public  void  dumpTolFC(SDAI.Iang.Model_contents  me)  { 
if  (dumpingTolFC)  return; 
dumpingTolFC  =  true; 

try  { 

II  move  this  object  to  the  model  contents 
if  (this  instanceof  SDAl.lang.AppJnst)  { 

if  (classNameFinalPortionQ.startsWithf'Clfc")  || 
classNameFinalPortion().startsWith(''Elfc"))  { 
mc.movelnstance((SDAI.Iang.App_inst)this); 

} 

} 

II  go  up  heirarchy  chain  adding  parent  class  fields 
Class  superC  =  getClass().getSuperclass(); 
while  (superC  !=  null)  { 

if  (superC  ==  Class.forNamef'java.Iang.Object”)) 
superC  =  null; 

else  if  (superC  ==  Class.forName("SDAI.COM.steptools.CApp_inst”)) 
superC  =  null; 

else  if  (superC  ==  Class.forName("SDAI.COM.steptools.Slfc150final.MDSApplnst")) 
superC  =  null; 

else  { 

dumpTolFCHelper(superC,  this,  me); 
superC  =  superC.getSuperclass(); 

} 

} 

II  add  main  class  fields 
dumpTolFCHelper(getClass(),  this,  me); 
dumpingTolFC  =  false; 

} 

catch  (Exception  exc)  { 

System.out.printlnf'Exception  Dumping  - 1: "  +  this); 

exc.printStackTrace(); 

dumpingTolFC  =  false; 

} 

} 

private  void  dumpTolFCHelper(Class  c,  Object  inst,  Model_contents  me)  { 

try  { 

II  check  for  any  fields  to  be  moved  to  the  model  contents 
Fieldj]  fields  =  c.getDeclaredFields(); 
for  (int  i  =  0;  i  <  fields.length;  i++)  { 

try  { 

Object  obj  =  fields[i].get(inst); 
if  (obj  !=  null)  { 

if  (obj  instanceof  lnt_MDSDumpTolFC)  { 

((lnt_MDSDumpTolFC)obj).dumpTolFC(mc); 

} 

if  (obj.getClass().isArray())  { 

for  (int  j  =  0;  j  <  Array.getLength(obj);  j++)  { 
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if  (Array.get(obj,  j)  instarceof  IntJVIDSDumpTolFC)  { 

((lnt_MDSDumpTolFC)Array.get(obj,  j)).dumpTolFC(mc); 

} 

} 

} 

} 

} 

catch  (HlegalAccessException  exc)  { 

System.out.println("Exception  Dumping  -  2: "  +  this); 

System  .out.  println("  1 1  legal  AccessException  on  Field: +  fields[i].getName()  + 

} 

} 

} 

catch  (Exception  exc)  { 

System.out.printlnfException  Dumping  -  3: "  +  this); 
exc.printStackTrace(); 

} 

} 

} 


MDSObject 

public  abstract  class  MDSObject  extends  MDSAppInst  implements  lnt_MDSObject  { 

public  static  String  MDSBasePropertySet  =  new  Stringf'MDSBasePropSet"); 

II - - - - - 

II  these  methods  are  redefined  in  subclasses! 

public  ElfcpropertytypedefO  getT  ypedefinitions()  { 

System.out.println(”MDSObject:getTypedefinitions,  SFIOULD  NOT  BE  HERE!"); 
return  null; 

} 

public  void  setTypedefinitions(Elfcpropertytypedef[]  v)  { 

System.out.println(”MDSObject:setTypedefinitions,  SHOULD  NOT  BE  HERE!"); 
return; 

} 

public  Elfcoccurrencepropertysetj]  getOccurrenceproperties()  { 

System.out.println("MDSObject:getOccurrenceproperties,  SHOULD  NOT  BE  HERE!"); 
return  null; 

} 

public  void  setOccurrenceproperties(Elfcoccurrencepropertyset[]  v)  { 

System.out.println("MDSObject:setOccurrenceproperties,  SHOULD  NOT  BE  HERE!''); 
return; 

} 

public  Elfcpropertysetj]  getExtendedproperties()  { 

System.out.println(''MDSObject:getExtendedproperties,  SHOULD  NOT  BE  HERE!"); 
return  null; 

} 

public  void  setExtendedproperties(Elfcpropertyset[]  v)  { 

System.out.println("MDSObject:setExtendedproperties,  SHOULD  NOT  BE  HERE!"); 
return; 

} 

II - 

11========================================================================= 

public  void  dump()  { 
super.dump(); 

System.out.println("\tProjectid: "  +  Projectid); 

II  dump  type  definitions 
if  (getTypedefinitions()  !=  null)  { 

System  .out.  println("\tT ype  Definitions:"); 

ElfcpropertytypedefO  props  =  getTypedefinitions(); 
for  (int  i  =  0;  i  <  props. length;  i++)  { 

System.out.println("\t\t"  +  props[i].getTypedefname()  + "  +  propsji]); 
if  (props[i].getSharedproperties()  !=  null)  { 

E  Ifcshared  propertyset[]  sharedProps  =  propsji],  getSharedproperties(); 
for  (int  j  =  0;  j  <  sharedProps. length;  j++)  { 

//if  (sharedProps[j].getDescriptor()  !=  null)  { 

System.out.println("\t\t\t"  +  shared  Propsjj]  .getDescri  ptor()  + "  +  sharedProps]]]); 

//} 

//else  { 

//System.out.printlnfW  +  sharedPropsjj]); 

//} 

} 

} 

props[i].dump(); 


II 


ERDC/CERL  TR-02-28 


113 


} 

System.out.println("\tDONE"); 

} 

else 

System.out.println("\tType  Definitions  =  NULL''); 

II  dump  occurrence  properties 
if  (getOccurrenceproperties()  !=  null)  { 

System.out.println("\tOccurence  Properties:11); 

ElfcoccurrencepropertysetQ  props  =  getOccurrenceproperties(); 
for  (int  i  =  0;  i  <  props.length;  i++)  props[i].dump(); 

System.out.println("\tDONE"); 

} 

else 

System.out.println("\tOccurence  Properties  =  NULL"); 

II  dump  extended  properties 
if  (getExtendedpropertiesQ  !=  null)  { 

System.out.println("\tExtended  Properties:''); 

Elfcpropertyset[]  propSets  =  getExtendedproperties(); 
for  (int  i  =  0;  i  <  propSets.length;  i++)  { 

II if  (propSets[i].getDescriptor()  !=  null)  { 

System.out.printlnfW  +  propSets[i]  .getDescri  ptor()  + "  +  propSets[i]); 

11} 

//else  { 

//System.out.printlnfW  +  propSets[i]); 

11} 

if  (propSets[i].getHasproperties()  !=  null)  { 

ElfcpropertyO  props  =  propSets[i].getHasproperties(); 
for  (int  j  =  0;  j  <  props.length;  j++)  { 

System.out.printlnfW  +  props[j]); 

} 

} 

} 

II  for(int  i  =  0;  i  <  props.length;  i++)  props[i].dump(); 

System.out.println("\tDONE"); 

} 

else 

System.out.println("\tExtended  Properties  =  NULL"); 

} 

//==========================================================================: 

II  PROPERTY  ROUTINES 

//==========================================================================: 

1/=========================================================================-. 

II  GENERAL  PROPERTY  ROUTINES 

1/=========================================================================-. 

//=========================================================================== 

II  PROPERTY  TYPE  DEFINITION  OBJECT  ROUTINES 
//==========================================================================: 

/** 

*  Returns  an  Elfcpropertytypedef  object  with  the  given  property  type  definition  name. 

*  Searches  through  the  objects  Elfcpropertytypedef  objects  (gotten  by  calling  getTypedefinitions()). 

*  The  return  value  is  null  if  not  found . 

*/ 

public  Elfcpropertytypedef  getPropertyTypeDef(String  propertyTypeDefName)  { 
if  (propertyTypeDefName  ==  null)  { 
return  null; 

} 

Elfcpropertytypedef  result  =  null; 

II  look  for  given  property  type  definition 
Elfcpropertytypedefj]  typeDefs  =  getTypedefinitions(); 
if  (typeDefs  !=  null)  { 

for  (int  i  =  0;  i  <  typeDefs.length;  i++)  { 

if  (typeDefs[i].getTypedefname()  !=  null)  { 

if  (typeDefs[i].getTypedefname().equals(propertyTypeDefName))  { 
result  =  typeDefsjij; 

} 

} 

} 

} 

return  result; 

} 

/** 


*  Adds  the  given  Elfcpropertytypedef  object. 

*  Adds  to  the  objects  Elfcpropertytypedef  objects  (gotten  by  calling  getTypedefinitions()). 

*  No  check  is  first  done  to  see  if  the  property  type  definition  already  exists. 

*/ 


public  void  addPropertyTypeDef(Elfcpropertytypedef  propertyTypeDef)  { 
if  (propertyTypeDef  ==  null)  { 
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return; 

} 

int  i: 

Elfcpropertytypedef[]  typeDefs  =  getTypedefinitions(); 

Elfcpropertytypedef[j  typeDefsNew; 
if  (typeDefs  !=  null)  { 

typeDefsNew  =  new  Elfcpropertytypedef[typeDefs.length  +  1]; 
for  (i  =  0;  i  <  typeDefs.length;  i++)  typeDefsNew[i]  =  typeDefs[i]; 
typeDefsNew[i]  =  propertyTypeDef; 

} 

else  { 

typeDefsNew  =  new  Elfcpropertytypedef[]  {propertyTypeDef); 

} 

setTypedefinitions(typeDefsNew); 

} 

/** 

*  Removes  the  given  Elfcpropertytypedef  object. 

*  Searches  through  the  objects  Elfcpropertytypedef  objects  (gotten  by  calling  getTypedefinitions()). 

*/ 

public  void  removePropertyTypeDef(Elfcpropertytypedef  propertyTypeDef)  { 
if  (propertyTypeDef  ==  null)  { 
return; 

} 

int  i; 

Elfcpropertytypedef!]  typeDefs  =  getTypedefinitions(); 

II  look  for  propertyTypeDef 
int  numFound  =  0; 
if  (typeDefs  !=  null)  { 

for  (i  =  0;  i  <  typeDefs.length;  i++)  { 

if  (typeDefs[i]  ==  propertyTypeDef)  numFound++; 

} 

} 

if  (numFound  ==  0)  { 
return; 

} 

II  copy  over  non-matching  type  definitions 
intj  =  0; 

Elfcpropertytypedef!]  typeDefsNew  =  new  Elfcpropertytypedef[typeDefs. length  -  numFound]; 
for  (i  =  0;  i  <  typeDefs.length;  i++)  { 

if  (typeDefs[i]  !=  propertyTypeDef)  typeDefsNew[j++]  =  typeDefs[i]; 

} 

setTypedefinitions(typeDefsNew); 

} 

//================================================================================================= 

II  SHARED  PROPERTY  SET  OBJECT  ROUTINES 

//=============================================================================================== 

/** 

*  Returns  an  Elfcsharedpropertyset  object  with  the  given  shared  property  set  descriptor  within  the 

*  given  Elfcpropertytypedef  object. 

*  Searches  through  the  Elfcpropertytypedef  propertyTypeDef s  Elfcsharedpropertyset  objects  (gotten  by  calling  getSharedpropertiesQ). 

*  The  return  value  is  null  if  not  found . 

*/ 

public  Elfcsharedpropertyset  getSharedPropertySet(Elfcpropertytypedef  propertyTypeDef,  String  propertySetDescriptor)  { 
if  (propertyTypeDef  ==  null)  { 
return  null; 

} 

Elfcsharedpropertyset  result  =  null; 

II  look  for  given  shared  property  set  descriptor 

Elfcsharedpropertyset]]  sharedProps  =  propertyTypeDef.getSharedproperties(); 
if  (sharedProps  !=  null)  { 

for  (int  i  =  0;  i  <  sharedProps. length;  i++)  { 

if  (sharedProps[i].getDescriptor()  !=  null)  { 

if  (sharedProps[i].getDescriptor().equals(propertySetDescriptor))  { 
result  =  sharedProps[i]; 

} 

} 

} 

} 

return  result; 

} 

/** 


*  Returns  an  Elfcsharedpropertyset  object  with  the  given  shared  property  set  descriptor  within  the 

*  given  Elfcsharedpropertyset  object. 

*  Searches  through  the  Elfcsharedpropertyset  sharedPropertySet's  Elfcproperty  objects  (gotten  by  calling  getHasproperties()). 

*  The  return  value  is  null  if  not  found. 


*/ 


public  Elfcsharedpropertyset  getSharedPropertySet(Elfcsharedpropertyset  sharedPropertySet,  String  propertySetDescriptor)  { 
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if  (sharedPropertySet  ==  null)  { 
return  null; 

} 

Elfcsharedpropertyset  result  =  null; 

II  look  for  given  shared  property  set  descriptor 
ElfcpropertyO  props  =  sharedPropertySet.getHasproperties(); 
if  (props  !=  null)  { 

for  (int  i  =  0;  i  <  props.length;  i++)  { 

if  (props[i]  instanceof  Elfcsharedpropertyset)  { 

if  (((Elfcsharedpropertyset)props[i]).getDescriptor()  !=  null)  { 

if  (((Elfcsharedpropertyset)props[i]).getDescriptor().equals(propertySetDescriptor))  { 
result  =  (Elfcsharedpropertyset)propsp]; 

} 

} 

} 

} 

} 

return  result; 


*  Adds  the  given  Elfcsharedpropertyset  object  to  the  given  Elfcpropertytypedef  object. 

*  Searches  through  the  Elfcpropertytypedef  propertyTypeDef's  Elfcsharedpropertyset  objects  (gotten  by  calling  getSharedpropertiesQ). 

*  No  check  is  first  done  to  see  if  the  shared  property  set  already  exists. 

*/ 

public  void  addSharedPropertySet(Elfcpropertytypedef  propertyTypeDef,  Elfcsharedpropertyset  sharedPropertySet)  { 
if  (propertyTypeDef  =  null  ||  sharedPropertySet  ==  null)  { 
return; 

} 

int  i: 

Elfcsharedpropertyset!]  propSets  =  propertyTypeDef.getSharedproperties(); 

Elfcsharedpropertyset!]  propSetsNew; 
if  (propSets  !=  null)  { 

propSetsNew  =  new  Elfcsharedpropertyset[propSets.length  +  1]; 
for  (i  =  0;  i  <  propSets.length;  i++)  propSetsNew[i]  =  propSets[i]; 
propSetsNew[i]  =  sharedPropertySet; 

} 

else  { 

propSetsNew  =  new  Elfcsharedpropertyset!]  {sharedPropertySet}; 

} 

propertyTypeDef.setSharedproperties(propSetsNew); 

} 

/** 

*  Adds  the  given  Elfcsharedpropertyset  object  to  the  given  Elfcsharedpropertyset  object. 

*  Searches  through  the  Elfcsharedpropertyset  sharedPropertySet's  Elfcproperty  objects  (gotten  by  calling  getHasproperties()). 

*  No  check  is  first  done  to  see  if  the  shared  property  set  already  exists. 

*/ 

public  void  addSharedPropertySet(Elfcsharedpropertyset  sharedPropertySetl ,  Elfcsharedpropertyset  sharedPropertySet2)  { 
if  (sharedPropertySetl  ==  null  ||  sharedPropertySet2  ==  null)  { 
return; 

} 

int  i 

ElfcpropertyO  props  =  sharedPropertySetl  getHasproperties(); 

ElfcpropertyO  propsNew; 
if  (props  !=  null)  { 

propsNew  =  new  Elfcproperty[props.length  +  1]; 
for  (i  =  0;  i  <  props.length;  i++)  propsNew[i]  =  props[i]; 
propsNew[i]  =  sharedPropertySet2; 

} 

else  { 

propsNew  =  new  ElfcpropertyO  {sharedPropertySet2}; 

} 

sharedPropertySetl  .setHasproperties(propsNew); 

} 

/** 

*  Removes  the  given  Elfcsharedpropertyset  object  from  the  given  Elfcpropertytypedef  object. 

*  Searches  through  the  Elfcpropertytypedef  propertyTypeDef s  Elfcsharedpropertyset  objects  (gotten  by  calling  getSharedpropertiesQ). 

*/ 

public  void  removeSharedPropertySet(Elfcpropertytypedef  propertyTypeDef,  Elfcsharedpropertyset  sharedPropertySet)  { 
if  (propertyTypeDef  ==  null  ||  sharedPropertySet  ==  null)  { 
return; 

} 

int  i 

Elfcsharedpropertyset!]  propSets  =  propertyTypeDef.getSharedpropertiesQ; 

II  look  for  sharedPropertySet 
int  numFound  =  0; 
if  (propSets  !=  null)  { 

for  (i  =  0;  i  <  propSets.length;  i++)  { 
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if  (propSets[i]  ==  sharedPropertySet)  numFound++; 

} 

} 

if  (numFound  ==  0)  { 
return; 

} 

II  copy  over  non-matching  property  sets 
intj  =  0; 

Elfcsharedpropertyset[]  propSetsNew  =  new  Elfcsharedpropertyset[propSets.length  -  numFound]; 
for  (i  =  0;  i  <  propSets.length;  i++)  { 

if  (propSetsfi]  !=  sharedPropertySet)  propSetsNew[j++]  =  propSets[i]; 

} 

propertyTypeDef.setSharedproperties(propSetsNew); 

} 

/** 

*  Removes  the  given  Elfcsharedpropertyset  object  from  the  given  Elfcsharedpropertyset  object. 

*  Searches  through  the  Elfcsharedpropertyset  sharedPropertySet's  Elfcproperty  objects  (gotten  by  calling  getHasproperties()). 

*1 

public  void  removeSharedPropertySet(Elfcsharedpropertyset  sharedPropertySetl ,  Elfcsharedpropertyset  sharedPropertySet2)  { 
if  (sharedPropertySetl  ==  null  ||  sharedPropertySet2  ==  null)  { 
return; 

} 

int  I 

Elfcpropertyj]  props  =  sharedPropertySetl  .getHasproperties(); 

II  look  for  sharedPropertySet2 
int  numFound  =  0; 
if  (props  !=  null)  { 

for  (i  =  0;  i  <  props.length;  i++)  { 

if  (propsjij  ==  sharedPropertySet2)  numFound++; 

} 

} 

if  (numFound  ==  0)  { 
return; 

} 

II  copy  over  non-matching  property  sets 
intj  =  0; 

Elfcpropertyj]  propsNew  =  new  Elfcpropertyjprops.length  -  numFound]; 
for  (i  =  0;  i  <  props.length;  i++)  { 

if  (propsjij  !=  sharedPropertySet2)  propsNew[j++]  =  propsji]; 

} 

sharedPropertySetl  .setHasproperties(propsNew); 

} 

//================================================================================================= 

II  EXTENDED  PROPERTY  OBJECT  ROUTINES 

//================================================================================================= 

/** 

*  Returns  an  Elfcpropertyset  object  with  the  given  property  set  descriptor. 

*  Searches  through  the  objects  Elfcpropertyset  objects  (gotten  by  calling  getExtendedpropertiesQ). 

*  The  return  value  is  null  if  not  found . 

*/ 

public  Elfcpropertyset  getExtendedPropertySet(String  propertySetDescriptor)  { 
if  (propertySetDescriptor  ==  null)  { 
return  null; 

} 

Elfcpropertyset  result  =  null; 
if  (getExtendedpropertiesQ  !=  null)  { 

Elfcpropertysetj]  propSets  =  getExtendedpropertiesQ; 
for  (int  i  =  0;  i  <  propSets.length;  i++)  { 

if  (propSets[i].getDescriptor().equals(propertySetDescriptor))  { 
result  =  propSetsjij; 

} 

} 

} 

return  result; 

} 

/** 

*  Adds  the  given  Elfcpropertyset  object. 

*  Adds  to  the  objects  Elfcpropertyset  objects  (gotten  by  calling  getExtendedpropertiesQ). 

*  No  check  is  first  done  to  see  if  the  extended  property  set  already  exists. 

*/ 

public  void  addExtendedPropertySet(Elfcpropertyset  propertySet)  { 
if  (propertySet  ==  null)  { 
return; 

} 

Elfcpropertysetj]  propSets  =  getExtendedpropertiesQ; 

Elfcpropertysetj]  propSetsNew; 
if  (propSets  !=  null)  { 
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int  i; 

propSetsNew  =  new  Elfcpropertyset[propSets.  length  +  1]; 
for  (i  =  0;  i  <  propSets.length;  i++)  propSetsNew[i]  =  propSets[i]; 
propSetsNew[i]  =  propertySet; 

} 

else  { 

propSetsNew  =  new  Elfcpropertyset[]  {propertySet}; 

} 

setExtendedproperties(propSetsNew); 

} 

/** 

*  Removes  the  given  Elfcpropertyset  object. 

*  Searches  through  the  objects  Elfcpropertyset  objects  (gotten  by  calling  getExtendedproperties()). 

*/ 

public  void  removeExtendedPropertySet(Elfcpropertyset  propertySet)  { 
if  (propertySet  ==  null)  { 
return; 

} 

int  i 

Elfcpropertyset[]  propSets  =  getExtendedpropertiesQ; 

II  look  for  propertySet 
int  numFound  =  0; 
if  (propSets  !=  null)  { 

for  (i  =  0;  i  <  propSets.length;  i++)  { 

if  (propSets[ij  ==  propertySet)  numFound++; 

} 

} 

if  (numFound  ==  0)  { 
return; 

} 

II  copy  over  non-matching  property  sets 
intj  =  0; 

Elfcpropertyset!]  propSetsNew  =  new  Elfcpropertyset[propSets.length  -  numFound]; 
for  (i  =  0;  i  <  propSets.length;  i++)  { 

if  (propSets[ij  !=  propertySet)  propSetsNew[j++]  =  propSets[ij; 

} 

setExtendedproperties(propSetsNew); 

} 

//======================================================================================== 

II  PROPERTY  SET  OBJECT  ROUTINES  FOR  ACCESSING  SIMPLE  PROPERTY  OBJECTS 
//======================================================================================== 

/** 

*  Returns  an  Elfcsimpleproperty  object  with  the  given  property  set  descriptor. 

*  Searches  through  the  Elfcpropertyset  propertySet's  Elfcproperty  objects  (gotten  by  calling  getHasproperties()). 

*  The  return  value  is  null  if  not  found . 

*/ 

public  Elfcsimpleproperty  getSimpleProperty(Elfcpropertyset  propertySet,  String  simplePropertyDescriptor)  { 
if  (propertySet  ==  null  ||  simplePropertyDescriptor  ==  null)  { 
return  null; 

} 

Elfcsimpleproperty  result  =  null; 
if  (propertySet.getHaspropertiesQ  !=  null)  { 

Elfcproperty!]  props  =  propertySet.gethlaspropertiesQ; 
for  (int  i  =  0;  i  <  props.length;  i++)  { 

if  (props[ij  instanceof  Elfcsimpleproperty)  { 

if  (((Elfcsimpleproperty)props[i]).getDescriptor().equals(simplePropertyDescriptor))  { 
result  =  (Elfcsimpleproperty)props[ij; 

} 

} 

} 

} 

return  result; 

} 

/** 

*  Adds  the  given  Elfcsimpleproperty  object  to  the  given  Elfcpropertyset  object. 

*  Adds  to  the  Elfcpropertyset  propertySet's  Elfcproperty  objects  (gotten  by  calling  getHaspropertiesQ). 

*  No  check  is  first  done  to  see  if  the  simple  property  already  exists. 

*/ 

public  void  addSimpleProperty(Elfcpropertyset  propertySet,  Elfcsimpleproperty  property)  { 
if  (propertySet  ==  null  |j  property  ==  null)  { 
return; 

} 

Elfcproperty!]  props  =  propertySet.getHasproperties(); 

Elfcproperty!]  propsNew; 
if  (props  !=  null)  { 
int  i; 

propsNew  =  new  Elfcproperty[props.length  +  1j; 
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for  (i  =  0;  i  <  props.length;  i++)  propsNew[i]  =  props[i]; 
propsNew[i]  =  property; 

} 

else  { 

propsNew  =  new  Elfcproperty[]  {property}; 

} 

propertySet.setHasproperties(propsNew); 

} 

/** 

*  Removes  the  given  Elfcsimpleproperty  object  from  the  given  Elfcpropertyset  object. 

*  Searches  through  the  Elfcpropertyset  propertySet's  Elfcproperty  objects  (gotten  by  calling  getHasproperties()). 
*/ 

public  void  removeSimpleProperty(Elfcpropertyset  propertySet,  Elfcsimpleproperty  property)  { 
if  (propertySet  ==  null  ||  property  ==  null)  { 
return; 

} 

int  i; 

Elfcpropertyj]  props  =  propertySet.getHasproperties(); 

II  look  for  property 
int  numFound  =  0; 
if  (props  !=  null)  { 

for  (i  =  0;  i  <  props.length;  i++)  { 

if  (props[ij  ==  property)  numFound++; 

} 

} 

if  (numFound  ==  0)  { 
return; 

} 

II  copy  over  non-matching  properties 
intj  =  0; 

Elfcpropertyj]  propsNew  =  new  Elfcpropertyjprops.length  -  numFound]; 
for  (i  =  0;  i  <  props.length;  i++)  { 

if  (props[ij  !=  property)  propsNew[j++]  =  propsji]; 

} 

propertySet.setHasproperties(propsNew); 

} 

11==================================================================================== 

II  DEFAULT  MDS  PROPERTY  ROUTINES 

II ==================================================================================== 

private  void  setupMDSBasePropertySet()  { 

II  create  property  set 

elfcpropertyset  propSet  =  new  Clfcpropertyset(); 

propSet.setDescriptor(MDSObject.MDSBasePropertySet); 

addExtendedPropertySet(propSet); 

} 

private  Elfcpropertyset  getMDSBasePropertySet()  { 

return  getExtendedPropertySet(MDSObject.MDSBasePropertySet); 

} 

private  boolean  isMDSBasePropertySet()  { 
if  (getMDSBasePropertySetQ  !=  null)  { 
return  true; 

} 

return  false; 

} 

/** 

*  Returns  true  if  the  given  descriptor  exists  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*/ 

public  boolean  existsProperty(String  descriptor)  { 

if  (isMDSBasePropertySetQ  ==  false)  return  false; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySet(); 
return  getSimpleProperty(mdsBasePropSet,  descriptor)  !=  null; 

} 

/** 

*  Removes  the  given  descriptor  from  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  This  will  remove  all  properties  with  the  given  descriptor. 

*/ 

public  void  removeProperty(String  descriptor)  { 
if  (isMDSBasePropertySetQ  ==  false)  return; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  !=  null)  { 

removeSimpleProperty(mdsBasePropSet,  prop); 

} 

} 

/** 

*  Adds  a  new  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  No  check  is  made  first  if  the  descriptor  already  exists! 
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*  Sets  the  value  as  an  IFCDescriptiveMeasure. 

*/ 

public  void  addStringProperty(String  descriptor,  String  value)  { 

if  (isMDSBasePropertySet()  ==  false)  setupMDSBasePropertySetQ; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  ==  null)  { 

prop  =  new  Clfcsimpleproperty(); 

} 

prop.setDescriptor(descriptor); 
prop.getValuecomponent().setlfcdescriptivemeasure(value); 
addSimpleProperty(mdsBasePropSet,  prop); 

} 

/** 

*  Adds  a  new  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  No  check  is  made  first  if  the  descriptor  already  exists! 

*  Sets  the  value  as  an  IFCNumericMeasure. 

*/ 

public  void  addDoubleProperty(String  descriptor,  Double  value)  { 

if  (isMDSBasePropertySetQ  ==  false)  setupMDSBasePropertySetQ; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  ==  null)  { 

prop  =  new  ClfcsimplepropertyQ; 

} 

prop.setDescriptor(descriptor); 

prop.getValuecomponent().setlfcnumericmeasure(value.doubleValue()); 
addSimpleProperty(mdsBasePropSet,  prop); 

} 

/** 

*  Gets  the  property  type  of  the  property  with  this  descriptor  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  The  string  returned  relates  to  data  types  defined  in  the  IFC  documentation  for  IFCMeasureValue.  Ex:  <p> 

<pre> 

"Ifclengthmeasure" 

"Ifcmassmeasure" 

"Ifctimemeasure” 

"Ifcelectriccurrentmeasure" 

"Ifcthermodynamictemperatu  remeasure" 

"Ifcamountofsubstancemeasure" 

"Ifcluminousintensitymeasure" 

"Ifcplaneanglemeasure” 

"Ifcsolidanglemeasure" 

"Ifcareameasure" 

"Ifcvolumemeasure” 

"Ifcratiomeasure" 

"Ifcparametervalue" 

"Ifcnumericmeasure" 

"Ifccontextdependentmeasure" 

"Ifcdescriptivemeasure” 

"Ifcpositivelengthmeasure" 

"Ifcpositiveplaneanglemeasure" 

"Ifcpositiveratiomeasure" 

"Ifccountmeasure" 

"Ifccompoundplaneanglemeasure" 

"Ifctimeduration  measure" 

"Ifctimestamp" 

</pre> 

*  The  return  value  is  null  if  property  not  found. 

*/ 

public  String  getPropertyT ype(String  descriptor)  { 

if  (isMDSBasePropertySetQ  ==  false)  return  null; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  !=  null)  { 

return  prop.getValuecomponent().getUnderlying_type(); 

} 

return  null; 

} 

/** 

*  Gets  a  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  Returns  the  first  matching  descriptor! 

*  The  return  value  is  null  if  property  not  found. 

*/ 

public  String  getStringProperty(String  descriptor)  { 
if  (isMDSBasePropertySetQ  ==  false)  return  null; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySetQ; 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
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if  (prop  !=  null)  { 

return  prop.getValuecomponent().getlfcdescriptivemeasure(); 

} 

return  null; 

} 

/** 

*  Gets  a  property  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*  Returns  the  first  matching  descriptor! 

*  The  return  value  is  null  if  property  not  found. 

*/ 

public  Double  getDoubleProperty(String  descriptor)  { 
if  (isMDSBasePropertySetQ  ==  false)  return  null; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySet(); 

Elfcsimpleproperty  prop  =  getSimpleProperty(mdsBasePropSet,  descriptor); 
if  (prop  !=  null)  { 

return  new  Double(prop.getValuecomponent().getlfcnumericmeasure()); 

} 

return  null; 

} 

/** 

*  Gets  a  vector  of  descriptors  in  a  default  shared  property  set;  MDSObject.MDSBasePropertySet. 

*/ 

public  Vector  getPropertyTitles()  { 

Vector  result  =  new  Vector)); 
if  (isMDSBasePropertySetQ  ==  false)  return  result; 

Elfcpropertyset  mdsBasePropSet  =  getMDSBasePropertySet(); 

ElfcpropertyO  props  =  mdsBasePropSet.getHasproperties(); 
if  (props  !=  null)  { 

for  (int  i  =  0;  i  <  props.length;  i++)  { 

result.addElement(((Elfcsimpleproperty)props[i]).getDescriptor()); 

} 

} 

return  result; 

} 

} 


MDSProduct 


public  abstract  class  MDSProduct  extends  MDSObject  implements  lnt_MDSProduct  { 

/** 

*  A  local  placement  object  is  automatically  created. 

*  A  bounding  box  product  shape  (size  0, 0, 0)  is  automatically  created. 

*1 

public  MDSProduct()  { 

setLocalplacement(new  Clfclocalplacement(new  Clfcaxis2placement3d(new  Clfccartesianpoint(0, 0,  0)))); 
setProductshape(Clfcproductshape.productshape_boundingBox_create(0,  0, 0)); 

} 

II - - - 

II  these  methods  are  redefined  in  subclasses! 

public  Elfclocalplacement  getLocalplacement()  { 

System.out.println("MDSProduct:getLocalplacement,  SHOULD  NOT  BE  HERE!''); 
return  null; 

} 

public  void  setLocalplacement(Elfclocalplacement  v)  { 

System.out.println("MDSProduct:setLocalplacement,  SHOULD  NOT  BE  HERE!"); 
return; 

} 

public  Elfcproductshape  getProductshapeQ  { 

System.out.println("MDSProduct:getProductshape,  SHOULD  NOT  BE  HERE!1'); 
return  null; 

} 

public  void  setProductshape(Elfcproductshape  v)  { 

System.out.println("MDSProduct:setProductshape,  SHOULD  NOT  BE  HERE!"); 
return; 

} 

II - 

//=========================================================================================: 

II  LOCATION  ROUTINES 

//======================================================================================: 

public  void  setRelativeLocation(Elfccartesianpoint  location)  { 
if  (location  ==  null)  return; 
if  (getLocalplacement()  ==  null)  return; 

((Clfclocalplacement)getLocalplacement()).setRelativePlacementLocation(location); 
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public  void  setAbsoluteLocation(Elfccartesianpoint  location)  { 
if  (location  ==  null)  return; 
if  (getLocalplacement()  ==  null)  return; 
if  (getLocalplacement().getPlacementrelto()  ==  null)  return; 

if  (getLocalplacement().getPlacementrelto().islfcproduct()  ==  SDAl.lang.LOGICAL.TRUE) 

setRelativeLocation(Clfccartesianpoint.delete(location,  getLocalplacement().getPlacementrelto().getlfcproduct().getAbsoluteLocation())); 
setRelativeLocation(location); 

} 

public  Elfccartesianpoint  getRelativeLocation()  { 
if  (getLocalplacement()  ==  null)  return  null; 

return((Clfclocalplacement)getLocalplacement()).getRelativePlacementLocation(); 

} 

public  Elfccartesianpoint  getAbsoluteLocationQ  { 
if  (getLocalplacement()  ==  null)  return  null; 
if  (getLocalplacement().getPlacementrelto()  ==  null)  return  null; 
if  (getLocalplacement().getPlacementrelto().islfcproduct()  ==  SDAl.lang.LOGICAL.TRUE) 

return  Clfccartesianpoint.add(getLocalplacement().getPlacementrelto().getlfcproduct().getAbsoluteLocation(),  getRelativeLocationQ); 
return  getRelativeLocation(); 

} 

//============================================================================================== 

//ANGLE  ROUTINES 


public  void  setRelativeAngle(double  angle)  { 
if  (getLocalplacement()  ==  null)  return; 

((Clfclocalplacement)getLocalplacementQ).setRelativePlacementAngle(angle); 

} 

public  void  setAbsoluteAngle(double  angle)  { 
if  (getLocalplacementf)  ==  null)  return; 
if  (getLocalplacement().getPlacementrelto()  ==  null)  return; 

if  (getLocalplacement().getPlacementrelto().islfcproduct()  ==  SDAl.lang.LOGICAL.TRUE) 

setRelativeAngle(angle  -  getLocalplacement().getPlacementrelto().getlfcproduct().getAbsoluteAngle()); 
setRelativeAngle(angle); 

} 

public  double  getRelativeAngleQ  { 

if  (getLocalplacement()  ==  null)  return  0.0; 

return((Clfclocalplacement)getLocalplacement()).getRelativePlacementAngle(); 

} 

public  double  getAbsoluteAngle()  { 

if  (getLocalplacementf)  ==  null)  return  0.0; 

if  (getLocalplacement().getPlacementrelto()  ==  null)  return  0.0; 

if  (getLocalplacement().getPlacementrelto().islfcproduct()  ==  SDAl.lang.LOGICAL.TRUE) 

return(getLocalplacement().getPlacementrelto().getlfcproduct().getAbsoluteAngle()  +  getRelativeAngle()); 
return  getRelativeAngle(); 

} 

public  void  dump()  { 
super.dumpf); 

if  (getLocalplacementf)  !=  null)  { 

System.out.print("\tLocalplacement:\n");  getLocalplacement().dump(); 

} 

System.  out.print("\tLocation:"); 
if  (getRelativeLocation()  !=  null)  { 

System.out.printf'  Relative: "  +  getRelativeLocationf)); 

} 

if  (getAbsoluteLocation()  !=  null)  { 

System.out.printf  Absolute: "  +  getAbsoluteLocationQ); 

} 

System.out.printfV); 

System.out.print("\tAngle:"); 

System.out.printf"  Relative: "  +  Double.toString(getRelativeAngle())); 

System.out.printf'  Absolute: "  +  Double.toString(getAbsoluteAngleQ)); 

System.out.printfV); 

/* 

if  (getProductshapef)  !=  null)  { 

System.out.printlnfttBounding  Box:  Xdim: "  +  Double.toString(getBoundingXDim())  + 

",  Ydim: "  +  Double.toString(getBoundingYDim())  + 

",  Zdim: "  +  Double.toString(getBoundingZDim())); 

} 

*/ 

} 

} 
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Appendix  D:  PSE  Post-Processing  Batch 

File 


This  is  the  batch  file  that  is  used  to  post-process  the  object-model  and  it’s  helper 
classes.  The  order  that  these  are  done  is  important.  It  was  necessary  to  increase 
the  amount  of  memory  that  is  used  by  the  Java  virtual  machine  (reason  for  — 
mx32m  option). 

java  -mx32m  com.odi.filter.OSCFP  -verbose  -dest .  -inplace 
-nooptimizeclassinfo 

-pc  SDAl.COM.steptools.CSelect  SDAl.COM.steptools.CAppJnst 
-tf  SDAl.COM.steptools.CAppJnst.owner 
-tf  SDAI.COM.  steptools.CAppJnst.persistentlD 
java  -mx32m  com.odi.filter.OSCFP  -verbose  -dest .  -inplace 
MDSInterfacest*. class  sdai\sifc150final\*.class 
sdai\com\steptools\sifc150final\Clfc*.class 
sdai\com\steptools\sifc150final\lnv*.class 
sdai\com\steptools\sifc150final\MDS*.class 
java  -mx32m  com.odi.filter.OSCFP  -verbose  -dest .  -inplace 
-pa  SDAI.COM.steptools.Slfc150final.lnit 
SDAl.COM.steptools.Slfcl  50final.Roselnit 
SDAI.COM.steptools.Slfc150final.P21 
java  -mx32m  com.odi.filter.OSCFP  -verbose  -dest .  -inplace 
-pa  MDSControllers\*.class 
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Appendix  E:  Microsoft  Access  Tables 


The  following  are  the  tables  and  their  structure  for  the  Microsoft  Access  data¬ 
base  that  is  read  from  within  the  Building  Composer  core  library. 


Table:  ActivityHeaders 

Description:  Activity  Definitions.  Table  read  from  BuildingComposer! 
Columns 


Name 

Type 

Size 

Name 

Text 

50 

Description 

ext 

100 

Table:  BuildingHeaders 

Description:  Building  Definitions.  Table  read  from  BuildingComposer! 
Columns 


Name 

Type 

Size 

ID 

Text 

50 

Description 

Text 

250 

Table:  FunctionHeaders 

Description:  Function  Definitions. 
Columns 

Name 

Type 

Size 

ID 

Text 

15 

Name 

Text 

50 

Description 

Text 

100 

ActivityName 

Text 

50 

Height 

Double 

8 

Table:  FunctionParentFunctionLinks 

Description:  Link  a  parent  function  with  a  child  function. 

Columns 

Name 

Type 

Size 

F  unctionN  ame 

Text 

50 

ParentFunctionName 

Text 

50 

124 


ERDC/CERL  TR-02-28 


Table:  FunctionReqSetLinks 

Description:  Link  a  function  with  a  requirement  set.  Table  read  from  Building 

Composer! 

Columns 

Name 

Type  Size 

F  unctionN  ame 

Text  50 

ReqSetName 

Text  50 

Table:  FunctionRequirementLink 

Columns 

Name 

Type 

Size 

F  unctionN  ame 

Text 

50 

RequirementName 

Text 

50 

Value 

Text 

255 

ValueCanBeChanged 

Yes/No 

1 

Source 

Text 

255 

Table:  FunctionSubFunctionLinks 

Description:  Link  a  super  function  with  a  sub  function. 
Columns 


Name 

Type 

Size 

F  unctionN  ame 

Text 

50 

SubFunctionName 

Text 

50 

Table:  Librarylnfo 

Properties 

Description:  Library  Information. 

Table  read  from  BuildingComposer! 

Columns 

Name 

Type 

Size 

ID 

Long  Integer 

4 

Version 

Text 

50 

Date 

Date/Time 

8 

Name 

Text 

50 

Description 

Text 

250 

EnglishUnits 

Yes/No 

1 

Client 

Text 

50 

Comment 

Text 

250 

UpdatedBy 

Text 

50 
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Table:  RequirementHeaders 

Description:  Requirement  Definitions.  Table  read  from  BuildingComposer! 
Columns 


Name 

Type 

Size 

ID 

Text 

50 

DisplayName 

Text 

50 

Description 

Text 

200 

RequirementSetName 

Text 

50 

Level 

Long  Integer 

4 

Datatype 

Long  Integer 

4 

Value 

Text 

255 

UOM 

Text 

50 

IsRequired 

Yes/No 

1 

ValueCanBeChanged 

Yes/No 

1 

MultiValue 

Yes/No 

1 

Source 

Text 

200 

Table:  RequirementMultiValues 

Description:  MultiValue  Definitions. 

Table  read  from  BuildingComposer! 

Columns 

Name 

Type 

Size 

ID 

Long  Integer 

4 

RequirementName 

Text 

50 

Value 

Text 

50 

Table:  RequirementSetHeaders 

Description:  Requirement  Set  Definitions.  Table  read  from  Building  Composed. 
Columns 


Name 

Type 

Size 

Name 

Text 

50 

Description 

Text 

200 

TabName 

Text 

15 
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Appendix  F:  Additional  Information  on 

Library  Creation  and  Usage 


Process  for  reading/processing/using  application/extension  data: 

1.  After  the  application  is  started,  existing  function  templates  (with  their  require¬ 
ment  sets  and  requirements)  are  read  into  the  main  default  library  for  Building 
Composer.  This  is  done  so  that  all  function  templates  reference  the  same  re¬ 
quirement  sets  and  requirements.  Mainly  this  is  so  that  many  similar  objects  are 
not  created  in  the  database.  It  is  desirable  for  all  functions  in  the  library  to  use 
the  same  requirement  sets  and  requirements,  whether  existing  or  new. 

2.  The  main  Access  database  is  read  for  Building  Composer. 

a.  The  activities  are  read  in  (MDSActivity  objects  created). 

b.  The  requirement  sets  are  read  in  (MDSRequirementSet  objects  are  cre¬ 
ated).  They  are  put  into  a  generic  requirement  set  vector  and  a  function 
requirement  set  vector.  The  function  requirement  set  vector  is  used  when 
a  function  instance  is  created.  The  generic  requirement  set  vector  is  used 
all  other  times.  Requirement  sets  and  requirements  read  in  step  1  are 
not  added.  An  example  of  why  this  is  done  follows.  Suppose  there  is  a 
requirement  set  with  both  function  and  non-function  requirements.  If 
that  requirement  set  is  told  in  step  2-d  to  be  specifically  linked  to  a  func¬ 
tion,  then  all  of  those  requirements  will  be  added.  Therefore  is  makes 
sense  to  split  function  requirements  from  non-function  requirements. 

c.  The  requirements  are  read  in  (MDSProperty  objects  created).  If  they  are 
generic,  then  they  are  linked  to  requirement  sets  in  the  generic  vector.  If 
they  are  for  a  function  they  are  linked  to  requirement  sets  in  the  function 
vector. 

d.  The  functions  are  read  in  (MDSFunctionTemplate  objects  created).  Spe¬ 
cifically  linked  functions/requirement  sets  (table  FunctionReqSetLinks) 
are  done. 

e.  Function/Property  override  values  are  read  in. 

f.  The  function  templates  are  updated  to  have  all  required  requirements. 
This  is  done  so  that  when  a  function  template  is  highlighted  in  the  Import 
dialog,  it  shows  the  requirements  that  will  be  loaded. 
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3.  When  an  extension  is  loaded,  the  data  from  its  Access  database  is  read  into  the 
main  default  library  for  Building  Com poser  (following  step  2). 

4.  When  a  non-function  instance  object  is  created,  the  main  default  library  for 
Building  Composer  is  searched  for  requirements  to  add  (using  requirement  sets 
in  the  generic  vector). 

5.  When  a  function  instance  object  is  created: 

a.  Requirement  sets  and  requirements  are  copied  from  the  function  tem¬ 
plate. 

b.  The  main  default  library  for  Building  Composer  is  searched  for  require¬ 
ments  to  add  (using  requirement  sets  in  the  function  vector). 

c.  The  function/property  override  values  are  checked. 

d.  When  a  combobox  is  required  for  requirement  values,  the  library  related 
to  the  extension  is  searched  for  multivalue  options  (table  Requirement  - 
MultiValues). 
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